フィードバック 編集

場所を更新する

  • [アーティクル]

名前空間: microsoft.graph

重要

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

place オブジェクトのプロパティ (room または roomList) を更新します。 id または emailAddress プロパティを指定することで、room または roomList を識別できます。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校アカウント) Place.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション サポート対象外

HTTP 要求

PATCH /places/{id | emailAddress}

要求ヘッダー

名前 値
Authorization ベアラー {token}。必須。
Content-Type application/json. Required.

要求本文

要求本文で、更新する関連フィールドの値を指定します。 一度に更新できる場所リソース (room または roomList) のインスタンスは 1 つだけです。 要求本文で、場所の種類を指定し、更新するその型のプロパティを含めるために使用 @odata.type します。 要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。 最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。

プロパティ 種類 説明
address physicalAddress ルームまたはルームリストの住所。
audioDeviceName 文字列型 (String) ルーム内のオーディオ デバイスの名前を指定します。
bookingType bookingType 部屋の種類。 可能な値は、Standard と Reserved です。
建物 文字列型 (String) 会議室の建物名または建物番号を指定します。
容量 Int32 会議室の容量を指定します。
displayDeviceName 文字列型 (String) 会議室内のディスプレイ デバイスの名前を指定します。
floorLabel 文字列型 (String) 部屋の上にある床文字を指定します。
floorNumber Int32 会議室のフロア番号を指定します。
geoCoordinates outlookGeoCoordinates 緯度、経度、必要に応じて高度座標で、部屋またはルームリストの場所を指定します。
isWheelChairAccessible ブール値 部屋が車いすでアクセスできるかどうかを指定します。
ラベル 文字列 部屋のわかりやすいラベル (数値や名前など) を指定します。
ニックネーム 文字列型 (String) ルームのニックネーム ("conf room" など) を指定します。
phone String ルームまたはルームリストの電話番号。
tags String collection ビューの種類や家具の種類などの詳細など、部屋の追加機能を指定します。
videoDeviceName 文字列型 (String) 会議室内のビデオ デバイスの名前を指定します。

応答

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

例

例 1: ルームを更新する

要求

要求の例を次に示します。

PATCH https://graph.microsoft.com/beta/places/cf100@contoso.com
Content-type: application/json

{
  "@odata.type": "microsoft.graph.room",
  "nickname": "Conf Room",
  "building": "1",
  "label": "100",
  "capacity": 50,
  "isWheelChairAccessible": false
}

応答

応答の例を次に示します。

注意

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

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#places/$entity",
    "@odata.type": "#microsoft.graph.room",
    "id": "3162F1E1-C4C0-604B-51D8-91DA78989EB1",
    "emailAddress": "cf100@contoso.com",
    "displayName": "Conf Room 100",
    "address": {
      "street": "4567 Main Street",
      "city": "Buffalo",
      "state": "NY",
      "postalCode": "98052",
      "countryOrRegion": "USA"
    },
    "geoCoordinates": {
      "latitude": 47.0,
      "longitude": -122.0
    },
    "phone": "555-555-0100",
    "nickname": "Conf Room",
    "label": "100",
    "capacity": 50,
    "building": "1",
    "floorLabel": "1P",
    "floorNumber": 1,
    "isManaged": true,
    "isWheelChairAccessible": false,
    "bookingType": "standard",
    "tags": [
      "bean bags"
    ],
    "audioDeviceName": null,
    "videoDeviceName": null,
    "displayDevice": "surface hub"
}

例 2: ルームリストを更新する

要求

要求の例を次に示します。

PATCH https://graph.microsoft.com/beta/places/Building1RroomList@contoso.onmicrosoft.com
Content-type: application/json

{
  "@odata.type": "microsoft.graph.roomList",
  "displayName": "Building 1",
  "phone":"555-555-0100",
  "address": {
    "street": "4567 Main Street",
    "city": "Buffalo",
    "state": "NY",
    "postalCode": "98052",
    "countryOrRegion": "USA"
  },
  "geoCoordinates": {
    "altitude": null,
    "latitude": 47.0,
    "longitude": -122.0,
    "accuracy": null,
    "altitudeAccuracy": null
 }
}

応答

応答の例を次に示します。

注意

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

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#places/$entity",
  "@odata.type": "#microsoft.graph.roomList",
  "id": "DC404124-302A-92AA-F98D-7B4DEB0C1705",
  "displayName": "Building 1",
  "address": {
    "street": "4567 Main Street",
    "city": "Buffalo",
    "state": "NY",
    "postalCode": "98052",
    "countryOrRegion": "USA"
  },
  "geoCoordinates": {
    "altitude": null,
    "latitude": 47.0,
    "longitude": -122.0,
    "accuracy": null,
    "altitudeAccuracy": null
 },
  "phone": "555-555-0100",
  "emailAddress": "bldg1@contoso.com"
}