次の方法で共有


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

名前空間: microsoft.graph

重要

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

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

places API の使用

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

roomworkspaceroomList などの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 場所の一意の識別子。 読み取り専用。 この識別子は不変ではなく、メールボックスまたはテナント構成に変更がある場合は変更できます。
phone String 場所の電話番号。
placeId String 場所の一意の変更できない識別子。 読み取り専用。 この識別子の値は、コマンドレットからGet-Mailbox返される ExternalDirectoryObjectId と等しくなります。

リレーションシップ

なし。

JSON 表記

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

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