次の方法で共有

場所を作成する

名前空間: microsoft.graph

新しい 場所 オブジェクトを作成します。

このメソッドを使用して、 建物、 床、 セクション、 部屋、 ワークスペース、 またはデスクの子オブジェクトの種類を作成することもできます。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

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

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

注: Exchange 管理 ロールは、場所を作成するために必要です。

HTTP 要求

POST /places

要求ヘッダー

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

要求本文

要求本文で、place オブジェクトの JSON 表現を 指定 します。

place オブジェクトの作成時に使用できるすべてのプロパティの一覧については、場所リソースに関するページを参照してください。

応答

成功した場合、このメソッドは応答コード 201 Created と、応答本文に place オブジェクトを返します。

例

例 1: 建物を作成する

次の例は、新しい 建物 オブジェクトを作成する方法を示しています。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.building",
  "displayName": "B001"
}

応答

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

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.building",
  "id": "767a31a7-6987-41c9-b829-ab351b8aab53",
  "placeId": "767a31a7-6987-41c9-b829-ab351b8aab53",
  "displayName": "B001"
}

例 2: フロアを作成する

次の例は、新しい floor オブジェクトを作成する方法を示しています。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.floor",
  "displayName": "F1",
  "parentId": "767a31a7-6987-41c9-b829-ab351b8aab53"
}

応答

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

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.floor",
  "id": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "placeId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "displayName": "F1",
  "parentId": "767a31a7-6987-41c9-b829-ab351b8aab53",
  "tags": [],
  "isWheelChairAccessible": false
}

例 3: セクションを作成する

次の例は、新しい セクション オブジェクトを作成する方法を示しています。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.section",
  "displayName": "S1",
  "parentId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955"
}

応答

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

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.section",
  "id": "1ad0f725-6885-49c5-9a47-3b22a1f9409d",
  "placeId": "1ad0f725-6885-49c5-9a47-3b22a1f9409d",
  "displayName": "S1",
  "parentId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "tags": [],
  "isWheelChairAccessible": false
}

例 4: デスクを作成する

次の例は、新しい デスク オブジェクトを作成する方法を示しています。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.desk",
  "displayName": "D1",
  "parentId": "1ad0f725-6885-49c5-9a47-3b22a1f9409d"
}

応答

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

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.desk",
  "id": "fc25d4dc-817a-45bc-a72d-2616cd7566ac",
  "placeId": "fc25d4dc-817a-45bc-a72d-2616cd7566ac",
  "displayName": "D1",
  "parentId": "1ad0f725-6885-49c5-9a47-3b22a1f9409d",
  "tags": [],
  "isWheelChairAccessible": false,
  "mode": { "@odata.type": "#microsoft.graph.dropInPlaceMode" }
}

例 5: 部屋を作成する

次の例は、新しい room オブジェクトを作成する方法を示しています。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.room",
  "displayName": "Conf Room 4/3.3G11",
  "parentId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "bookingType": "standard"
}

応答

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

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.room",
  "id": "0be387a4-d53b-410f-9daf-f4fa07e5b05a",
  "placeId": "4923e5a8-453e-4edf-b272-9c33757d4fb3",
  "displayName": "Conf Room 4/3.3G11",
  "parentId": "46ef7aed-5d94-4fd4-ae03-b333bc7a6955",
  "isWheelChairAccessible": false,
  "emailAddress": "confroom433G115497308f1755150217899@contoso.com",
  "bookingType": "standard"
}

例 6: ワークスペースを作成する

次の例は、新しい ワークスペース オブジェクトを作成する方法を示しています。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/places
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.workspace",
  "parentId": "f7de7265-e420-47b4-9d49-28d728716241",
  "displayName": "testSpace001",
  "tags": ["test"]
}

応答

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

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.workspace",
  "id": "49c2fcfb-163a-4e00-a42b-0615d6789e72",
  "placeId": "d90144aa-8cc4-4d49-97f2-9c365e38ed7e",
  "displayName": "testSpace001",
  "parentId": "f7de7265-e420-47b4-9d49-28d728716241",
  "tags": [
    "test"
  ],
  "emailAddress": "testSpace0015d9988631755150528582@contoso.com",
  "nickname": "testSpace001",
  "mode": { }
}
  • Last updated on