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

[アーティクル]
07/03/2022

名前空間: microsoft.graph

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

places API の使用

Exchange Online管理者は、テナント内の会議室を会議室リストに整理できます。場所 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"
}