リソースの種類を配置する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
名前、物理アドレス、地理的座標などの基本的な場所属性を表します。 このリソースは、会議室、ワークスペース、roomList などの豊富な場所の種類の基本型です。
places API の使用
Exchange Online管理者は、テナント内の会議室とワークスペースを会議室リストに整理できます。 places API を使用すると、 リスト 操作を使用して、テナント内のすべての会議室、ワークスペース、または会議室リストを取得したり、特定の会議室リスト内の会議室とワークスペースを取得したりできます。
room、workspace、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 | 場所の一意の識別子。 読み取り専用。 この識別子は不変ではなく、メールボックスまたはテナント構成に変更がある場合は変更できます。 |
| 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)"
}
関連コンテンツ
- 管理者が会議室リストを作成するには、Exchange PowerShell コマンドレット New-DistributionGroup を使用します。
- 管理者が会議室の一覧に会議室を追加するには、Exchange Powershell コマンドレット Add-DistributionGroupMember を使用します。