フィードバック 編集

place リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

重要

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

名前、住所、地理座標などの基本的な場所の属性を表します。 これは、room や roomList など、より豊富な場所 の種類の 基本 型です。

Places API の使用

Exchange Online 管理者は、テナント内の会議室を会議室一覧に整理できます。 Places API を使用すると、テナント内のすべての部屋の一覧または部屋を取得したり、特定の部屋の一覧のすべての部屋を取得することができます。

room や roomList のような 場所には 、基本 ID、 表示名、メール アドレスが含まれる。 さらに、物理的な住所や地理的座標などのナビゲーション情報や、会議室の場合は、AV の機能、フロア番号、容量などの他の関連情報も含めます。

findRooms 関数と findRoomLists関数は、テナント内の会議室と会議室一覧の同様の検索をサポートします。 Places API とこれらの関数の比較を次に示します。 実稼働アプリを作成する場合は、API が v1.0 で一般提供される場所 API を選択します。 findRooms または findRoomLists は廃止され、タイムラインが発表される予定なので 、findRooms または findRoomLists を使用する既存のコードを更新して places API を使用する計画を立ててします。

Places API findRooms 関数と findRoomLists 関数
テナント内のすべての部屋または部屋の一覧、および会議室一覧内のすべての部屋の取得をサポートします。 同様のサポート - テナント内のすべての部屋または部屋の一覧、および会議室一覧内のすべての部屋を取得する
リストの場所 はテナント内の 100 以上のルームを返す場合があります findRooms は テナント内の最初の 100 ルームまで返します
テナント 内の個々の部屋または部屋の一覧の取得 をサポートします テナントでの個々の部屋または部屋の一覧の取得はサポートされていません
表示名と SMTP アドレスに加えて、より豊富なプロパティ セットを指定する room およびroomListの特定のエンティティを定義します。 各部屋と部屋の一覧は、表示名と SMTP アドレスのみを指定する軽量の emailAddress タイプです。
委任された (仕事または学校のアカウント) またはアプリケーションのアクセス許可を持つ組織のシナリオのみをサポートします 委任されたアクセス許可またはアプリケーションのアクセス許可を持つ組織のシナリオに対する同様のサポート
テナント 内の個々の部屋または部屋の一覧の更新 をサポートします テナント内の個々の部屋または部屋の一覧の更新はサポートされていません

メソッド

メソッド 戻り値の型 説明
場所を一覧表示する 要求された派生型の場所の コレクション テナントで定義されている指定された種類の 場所 オブジェクトのコレクションを取得します。
場所を取得する 要求された派生型の 場所 指定した場所オブジェクトのプロパティとリレーションシップを 取得 します。
更新場所 要求された派生型の 場所 指定した場所オブジェクトのプロパティとリレーションシップを 更新 します。

プロパティ

プロパティ 型 説明
address physicalAddress 場所の番地。
displayName String 場所に関連付けられている名前。
geoCoordinates outlookGeoCoordinates 場所の場所を緯度、経度、および (必要に応じて) 高度座標で指定します。
id String 場所の一意の識別子。 読み取り専用です。
phone String 場所の電話番号。

関係

なし。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "displayName": "String",
  "id": "String (identifier)",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "phone": "String"
}

関連項目