場所を取得する
名前空間: microsoft.graph
ID または電子メール アドレスで指定された 場所 オブジェクトのプロパティとリレーションシップを取得します。
place オブジェクトには、次のいずれかの型を指定できます。
- 会議室のメール アドレス、アクセシビリティ、容量、デバイスのサポートなど、豊富なプロパティを含む会議室。
- 会議室リストのメール アドレスと、その会議室リスト内の会議室インスタンスのコレクションを取得するためのナビゲーション プロパティを含む会議室リスト。
room と roomList の両方が place オブジェクトから派生します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | Place.Read.All | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | Place.Read.All | 注意事項なし。 |
HTTP 要求
GET /places/{id}
オプションのクエリ パラメーター
を使用して $select 、特定の 場所 のプロパティを取得します。
詳細については、「OData クエリ パラメーター」を参照してください。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと要求された place オブジェクトを応答本文に返します。
例
例 1: 部屋を取得する
要求
次の例では、そのプロパティを取得するルームの ID を指定します。
GET https://graph.microsoft.com/v1.0/places/979e9793-3e91-40eb-b18c-0ea937893956
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#places/$entity",
"@odata.type": "#microsoft.graph.roomList",
"id": "979e9793-3e91-40eb-b18c-0ea937893956",
"displayName": "Building 2 Rooms",
"address": null,
"geoCoordinates": null,
"phone": "",
"emailAddress": "Building2Rooms@contoso.com"
}
例 2: 会議室リストを取得する
要求
次の例では、roomList の emailAddress を指定してプロパティを取得します。
GET https://graph.microsoft.com/v1.0/places/Building2Rooms@contoso.com
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#places/$entity",
"@odata.type": "#microsoft.graph.roomList",
"id": "979e9793-3e91-40eb-b18c-0ea937893956",
"displayName": "Building 2 Rooms",
"address": null,
"geoCoordinates": null,
"phone": "",
"emailAddress": "Building2Rooms@contoso.com"
}