アップサートする場所

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

1 つ以上の 場所 オブジェクトを非同期モードでアップサートします。 この API を使用すると、1 つの要求で複数の場所を効率的に作成および更新できます。

シナリオ、ベスト プラクティス、同時実行の制限など、この API の使用方法の詳細については、「Microsoft Graph での upsert Places API の操作」を参照してください。

注:

  • 操作は、作成から 15 日間保持されます。
  • この API には、1 秒あたり 3 回の呼び出しの調整制限があります。 詳細については、「 Microsoft Graph サービス固有の調整制限」を参照してください。
  • すべての要求には OData-Version: 4.01 ヘッダーが必要です。
  • 現在、この API はデスクの割り当てモードや会議室の isTeamsEnabled プロパティをサポートしていません。
  • 現時点では、場所操作では多数の場所 (特に会議室、机、ワークスペース) を一度に処理することはできません。 現在の制限は、約 20 から 30 の会議室、机、またはワークスペースです。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Place.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Place.ReadWrite.All 注意事項なし。

重要

職場または学校アカウントを使用してアクセスを委任するには、サインインしたユーザーに、サポートされている Microsoft Entra ロール、またはこの操作に必要なアクセス許可を付与するカスタム ロールが割り当てられている必要があります。 Exchange 管理者は 、この操作でサポートされる最小特権ロールです。

アプリケーションのアクセス許可を使用する場合は、必須のTenantPlacesManagementロール (Placesを管理する場合) とMailRecipientロール (ユーザーとメールボックスを管理する場合) を構成する必要があります。 これらの役割を構成する方法の詳細については、「Role Based Access Control for Applications in Exchange Online」を参照してください。

HTTP 要求

PATCH /places

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. Required.
OData-Version 4.01. 必須です。

要求本文

リクエストの本文には、 場所 デルタ セットの JSON 表現を指定します。

場所オブジェクトを作成または更新するときと同じプロパティを指定できます。

応答

成功した場合、このメソッドは202 Accepted応答コードと、操作を取得するために使用できるLocation応答ヘッダー内の操作 URL を返します。

例

要求

次の例は、既存の建物の更新、階層を持つ新しい場所の作成、プロパティの更新など、複数の操作を組み合わせた要求を示しています。

  • 既存の建物を更新して表示名を Demo Building A に設定し、Wi-Fi を有効にし、更新された建物の子として新しいフロア Demo Floor 1 を作成します。
  • 新しいセクション Demo Section A、既存のデスクと新しい部屋Demo Room 1を含む子フロア Demo Floor 1を持つ新しい建物Demo Building Bを作成します。
  • 既存の親の下に予約可能モードで新しいワークスペースを作成します。
  • 既存のセクションの表示名を更新します。
PATCH https://graph.microsoft.com/beta/places
Content-Type: application/json
OData-Version: 4.01

{
  "@context": "#$delta",
  "value": [
    {
      "@odata.type": "microsoft.graph.building",
      "id": "25e5905a-7fee-4f36-ba31-29e85c14bf18",
      "displayName": "Demo Building A",
      "hasWifi": true,
      "children@delta": [
        {
          "@odata.type": "microsoft.graph.floor",
          "displayName": "Demo Floor 1"
        }
      ]
    },
    {
      "@odata.type": "microsoft.graph.building",
      "displayName": "Demo Building B",
      "children@delta": [
        {
          "@odata.type": "microsoft.graph.floor",
          "displayName": "Demo Floor 1",
          "children@delta": [
            {
              "@odata.type": "microsoft.graph.section",
              "displayName": "Demo Section A",
              "children@delta": [
                {
                  "@odata.type": "#microsoft.graph.desk",
                  "id": "211ffb37-e880-475a-b73a-43f484609536"
                },
                {
                  "@odata.type": "#microsoft.graph.room",
                  "displayName": "Demo Room 1"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "@odata.type": "microsoft.graph.workspace",
      "parentId": "2cb2701d-0896-4c69-91bb-582d82d7c68c",
      "displayName": "Demo Workspace 1",
      "mode": {
        "@odata.type": "#microsoft.graph.reservablePlaceMode"
      }
    },
    {
      "@odata.type": "#microsoft.graph.section",
      "id": "2cb2701d-0896-4c69-91bb-582d82d7c68c",
      "displayName": "HR"
    }
  ]
}

応答

次の例は応答を示しています。

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/places/getOperation(id='0f5d3cc5-d1bd-4cba-9b0e-e9ad68527ab5')
  • Last updated on