リソースの種類を配置する

  • [アーティクル]

名前空間: microsoft.graph

名前、物理アドレス、地理的座標などの基本的な場所属性を表します。 このリソースは、 room や roomList などの豊富な場所の種類の基本型です。

places API の使用

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

room や roomList などのPlacesには、基本的な ID、表示名、電子メール アドレスが含まれています。 さらに、物理的な住所や地理的座標などのナビゲーション情報が含まれています。また、部屋の場合は、AV 機能、フロア番号、容量などのその他の関連情報が含まれます。

findRooms 関数と findRoomLists 関数は、テナント内の会議室と会議室リストに対して同様の検索をサポートします。 次の表では、places API とこれらの関数を比較します。

メモ：findRooms 関数と findRoomLists 関数は非推奨です。

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

メソッド

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

プロパティ

プロパティ 型 説明
address physicalAddress 場所の番地。
displayName String 場所に関連付けられている名前。
geoCoordinates outlookGeoCoordinates 緯度、経度、(必要に応じて) 高度座標の場所を指定します。
id String 場所の一意の識別子。 読み取り専用です。 この識別子は不変ではなく、メールボックスまたはテナントの構成に変更がある場合は変更できます。 この API のベータ 版には、変更できない ID を提供する placeId という名前の新しいプロパティが追加されています。
phone String 場所の電話番号。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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

関連コンテンツ