重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Graph の Places API は、organization 内の建物、会議室、机、ワークスペースなどの物理的な空間を管理し、操作するための統一された方法を提供します。
サポートされる種類
Places API では、次のタイプがサポートされています。
場所の種類
場所は、テナント内のさまざまなスペース タイプを表します。 場所オブジェクトには、次のいずれかの種類を指定できます。
| 場所の種類 | 詳細 |
|---|---|
| 建物 | テナント内の建物を表し、名前、住所、地理座標などのプロパティを持ちます。 |
| デスク | 個々のデスクを表します。 セクションに机を追加する必要があります。 この セクション の豊富なプロパティには、メール アドレス、モード、アクセシビリティなどがあります。 |
| floor | name、parentId、sortOrder などのプロパティを含む、建物内のフロアを表します。 建物は常にフロアの親です。 |
| room | テナント内のルームを表します。 すべての会議室は Exchange メールボックスに関連付けられている必要があります。 部屋は、フロアまたはセクションに追加できます。 会議室の豊富なプロパティには、会議室のメール アドレス、アクセシビリティ、容量、オーディオ デバイス、ビデオ デバイスなどがあります。 |
| roomList | テナント内の会議室のコレクション。 Places は、デスクトップとモバイルの従来の Outlook など、すべてのデバイス上のすべてのクライアントで会議室の予約が Room Finder で機能するようにするために roomList をサポートしています。 ただし、テナントで roomFinder を使用しない場合は、新しい場所の種類と階層を使用することをお勧めします。 roomList の詳細については、roomList リソースの種類を参照してください。 |
| セクション | name、parentId、label などのプロパティを含む、フロア内のセクションを表します。 フロアは常にセクションの親です。 |
| ワークスペース | デスクのコレクションを表します。 すべてのワークスペースは、Exchange メールボックスに関連付けられている必要があります。 ワークスペースはセクションに追加できます。 ワークスペースの豊富なプロパティには、ワークスペース、モード、アクセシビリティ、容量のメール アドレスが含まれます。 |
マップ フィーチャの種類
マップ機能は、場所の対応するマップを表します。 マップ フィーチャ オブジェクトは、次のいずれかの種類になります。
| マップ フィーチャの種類 | 詳細 |
|---|---|
| buildingMap | Places の建物に関連付けられているマップ ファイルを表します。 このオブジェクトは、building.geojson の IMDF 形式表現です。 |
| fixtureMap | 空間内の移動可能または半永続的な物理アセットを定義する IMDF 形式の fixture.geojson ファイルを表します。 これらの資産は、構造の完全性に影響を与えることなく、実用性、サービス、または美的機能をサポートします。 |
| footprintMap | 参照されている 建物のおおよその物理的範囲を定義する IMDF 形式の footprint.geojson ファイルを表します。 |
| levelMap | 建物内の物理的な床構造を定義する IMDF 形式の level.geojson ファイルを表します。 |
| sectionMap | 建物の床のセクション (ゾーンやパーティションなど) を定義する IMDF 形式の section.geojson ファイルを表します。 |
| unitMap | 建物のフロアにユニット (部屋やオフィスなど) を定義する IMDF 形式の unit.geojson ファイルを表します。 |
Places API の使用
Places API を使用すると、適切な読み取りまたは書き込み権限を持つアプリケーションが place オブジェクトと対話できるようになります。 すべての 場所 オブジェクトには、 id、 placeId、 displayName などの基本的なプロパティが含まれます。 会議室、ワークスペース、デスクなどの高度な型では、 モード、 emailAddress、 deviceInformation などのプロパティが増えます。
Places のマップ API により、適切な読み取りまたは書き込み権限を持つアプリケーションがマップ フィーチャ オブジェクトと対話できるようになります。 各マップ フィーチャ オブジェクトには、ID などの基本的なプロパティと、placeId、geometry、display_point などのその他のプロパティが含まれます。
各タイプの詳細な説明については、それぞれのドキュメント セクションを参照してください。
Places リストと子孫 API の前提条件
List place objects または place: descendants API を使用するには、Microsoft 365 環境で Places 設定が適切に構成されていることを確認する必要があります。そうでない場合、次の設定手順が完了しない限り、これらの API は場所を返しません。
- MicrosoftPlaces PowerShell モジュールをダウンロードして接続します。 詳細については、「 Connect-MicrosoftPlaces」を参照してください。
- 次のコマンドを使用して建物を有効にして、場所を表示します。 詳細については、「 Set-PlacesSettings」を参照してください。
Set-PlacesSettings -EnableBuildings 'Default:true'
一般的なユース ケース
次の表に、Places API の一般的な使用方法の一部を示します。
| ユース ケース | REST リソース | 関連項目 |
|---|---|---|
| 場所の作成と管理 | place | place メソッド |
| 建物、フロア、セクション、会議室、会議室の一覧、ワークスペース、机などの場所空間を操作する | place | place メソッド |
| アップサートする場所 | place | アップサートする場所 |
| 建物のマップ ファイルを取り込む | 建物 | マップ ファイルの取り込み |
| 建物内のレベルを一覧表示する | levelMap | リスト レベル |
| 建物内のフットプリントの一覧表示 | footprintMap | フットプリントを一覧表示する |
| buildingMap を取得および削除する | buildingMap | buildingMap メソッド {{buildingMap めそっど}} |
| unitMap の作成と管理 | unitMap | unitMap メソッド |
| フィクスチャの作成と管理マップ | fixtureMap | fixtureMap メソッド |
| sectionMap の作成と管理 | sectionMap | sectionMap メソッド |
Places API と findRooms および findRoomLists の比較
findRooms 関数と findRoomLists 関数は、テナント内の会議室と会議室リストの同様の検索をサポートします。 次の表は、places API とこれらの関数を比較したものです。
注:
findRooms 関数と findRoomLists 関数は非推奨です。
| Places API | findRooms 関数と findRoomLists 関数 (非推奨) |
|---|---|
| テナント内のすべての会議室または会議室リストと、会議室リスト内のすべての会議室を取得します。 | テナント内のすべての会議室または会議室リストと、会議室リスト内のすべての会議室を取得します。 |
| List は、テナント内の 100 を超えるルームを返すことができます。 | findRooms は、テナントの最初の 100 個の会議室を返します。 |
| テナント内の 個々の会議室または会議室リストの取得 をサポートします。 | テナントでの個々の会議室または会議室の一覧の取得はサポートされていません。 |
| 表示名と SMTP アドレスに加えて、より豊富なプロパティ セットを指定する room と roomList の特定のエンティティを定義します。 | 各会議室と会議室の一覧は、表示名と SMTP アドレスのみを指定する軽量の emailAddress タイプです。 |
| 委任された (職場または学校アカウントの場合のみ) またはアプリケーションのアクセス許可を持つ組織のシナリオのみをサポートします。 | 委任されたアクセス許可またはアプリケーションのアクセス許可を持つ組織のシナリオのみをサポートします。 |
| テナント内の 個々の会議室または会議室リストの更新 をサポートします。 | テナント内の個々の会議室または会議室リストの更新はサポートされていません。 |
次の手順
Microsoft Graph Places API を使用して、さまざまな場所エンティティと対話します。 詳細情報
- 自分のシナリオに最も役立つリソースと方法を検討する。
- Graph エクスプローラーで API を試す。