名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
テナント内のさまざまなスペースの種類を表します。 詳細については、「Microsoft Graph での Places API の操作」を参照してください。
建物、デスク、フロア、ルーム、ルーム リスト、セクション、ワークスペースの基本タイプ。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| 場所を一覧表示する | コレクションを配置 | テナントで定義された指定した種類の 場所 オブジェクトのコレクションを取得します。 |
| 場所の作成 | place | 新しい 場所 オブジェクトを作成します。 |
| 場所を取得する | place | 場所オブジェクトのプロパティを読み取ります。 要求された 派生した場所の型を返します。 |
| 場所を更新する | place | 建物、フロア、セクション、デスク、ルーム、ワークスペース、またはルームリストなどの場所オブジェクトのプロパティを更新します。 |
| 場所の削除 | なし | 場所オブジェクトを削除する。 |
| 子孫の一覧表示 | コレクションを配置 | 特定の 種類の子孫をすべて場所の下に取得します。 |
| チェック保険請求の作成 | checkInClaim | 新しい checkInClaim オブジェクトを作成し、特定の予定表の予約に関連付けられている特定の場所 (デスク、会議室、ワークスペースなど) のチェックイン ステータスを記録します。 |
| アップサートする場所 | Location ヘッダー | 1 つ以上の 場所 オブジェクトを非同期モードでアップサートします。 |
| 操作を取得する | placeOperation | ID で placeOperation を取得します。 |
| リスト操作 | placeOperation コレクション | 既存のすべての placeOperation オブジェクトを一覧表示します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| address | physicalAddress | 住所 (番地、市区町村、都道府県、国または地域、郵便番号を含む) 。 |
| customProperties | stringDictionary | 場所のカスタム プロパティ。 各プロパティには文字列キーと文字列値があります。 Null 許容型。 |
| displayName | 文字列 | 場所に関連付けられている名前。 |
| geoCoordinates | outlookGeoCoordinates | 場所の場所を緯度、経度、および (オプションで) 高度座標で指定します。 |
| id | 文字列 | 場所の一意の識別子。 読み取り専用です。 この識別子は不変ではなく、メールボックスまたはテナントの構成が変更された場合に変更される可能性があります。 |
| isWheelChair Accessible(車椅子対応) | ブール型 | その 場所 が車いすでアクセスできるかどうかを示します。 |
| ラベル | 文字列 | 場所のユーザー定義の説明。 |
| lastUpdatedTime | DateTimeOffset | 場所が最後に更新された日時。 タイムスタンプは ISO 8601 形式で、常に UTC 形式です。 読み取り専用です。 Null 許容型。 |
| parentId | 文字列 | 親 場所の ID。 |
| phone | 文字列 | その場所の電話番号。 |
| placeId | 文字列 | Places ワークロードで使用される place オブジェクトの安定したサービスレベル識別子。 |
| tags | String collection | 分類またはフィルター処理を行う 場所 に関連付けられているカスタム タグ。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| checkIns | checkInClaim コレクション | 場所オブジェクトのサブリソースで、その場所で予約された Outlook 予定表イベントのチェック状態を示します。 |
| children | コレクションを配置 | Upsert places API でのみ使用される子場所のコレクション。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.place",
"address": {"@odata.type": "microsoft.graph.physicalAddress"},
"customProperties": {"String": "String"},
"displayName": "String",
"geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
"id": "String (identifier)",
"isWheelChairAccessible": "Boolean",
"label": "String",
"lastUpdatedTime": "String (timestamp)",
"parentId": "String",
"phone": "String",
"placeId": "String (alternative identifier)",
"tags": ["String"]
}