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

名前空間: microsoft.graphNamespace: microsoft.graph

名前、物理アドレス、地理的な座標などの基本的な場所の属性を表します。Represents basic location attributes such as name, physical address, and geographic coordinates. これは、 roomroomListなどの豊富な場所の種類の基本型です。This is the base type for richer location types such as room and roomList.

プレース API の使用Using the places API

Exchange Online 管理者は、テナント内の会議室を会議室一覧にまとめることができます。Exchange Online administrators can organize meeting rooms in a tenant into room lists. プレース API を使用すると、テナント内のすべての会議室一覧またはルームを取得したり、特定の会議室一覧のすべての会議室を取得したりできます。Using the places API, you can get all the room lists or rooms in the tenant, or get all the rooms in a specific room list.

RoomroomListなどの場所には、基本id、表示名、電子メールアドレスが含まれています。Places like room and roomList contain the basic id, display name and email address. また、物理アドレスと地理的な座標、ルームの場合は、AV 能力、フロア番号、容量などの他の関連情報などのナビゲーション情報も含まれます。In addition, they contain navigational information like physical address and geographical coordinates, and in the case of rooms, other relevant information such as AV capabilities, floor number, and capacity.

Findroomsおよびfin/omlists関数は、テナント内のルームおよび会議室一覧に類似した参照をサポートしています。The findRooms and findRoomLists functions support similar lookup for rooms and room lists in a tenant. 以下に、プレース API とこれらの関数の比較を示します。The following is a comparison between the places API and these functions. 運用アプリを作成している場合は、API が一般に v2.0 で利用可能になったので、[場所] API を選択します。If you are creating a production app, choose the places API as the API is now generally available in v1.0. Findroomsまたはfin/omomlists を使用して、場所の API を使用するように既存のコードを更新することを計画します。これは、 finは推奨されません。時間帯がアナウンスされます。Plan to update any existing code that uses findRooms or findRoomLists to use the places API, because findRooms or findRoomLists will be deprecated, and a timeline will be announced.

配置 APIPlaces API Findrooms および fin/Omlists 関数findRooms and findRoomLists functions
テナント内のすべての部屋または会議室一覧の取得、および会議室一覧のすべての会議室の取得をサポートしています。Supports getting all the rooms or room lists in a tenant, and all the rooms in a room list 同様のサポート-テナント内のすべてのルームまたはルームリストと、ルームリスト内のすべてのルームを取得します。Similar support - get all the rooms or room lists in a tenant, and all the rooms in a room list
リストの場所がテナント内の100ルームを超えることがあるList places can return more than 100 rooms in a tenant [Finomsは、テナント内の最初の100ルームに戻るfindRooms returns up to the first 100 rooms in a tenant
テナント内の個別の会議室または会議室一覧の取得をサポートしています。Supports getting an individual room or room list in a tenant テナント内の個別の会議室または会議室一覧の取得はサポートされていませんDoes not support getting an individual room or room list in a tenant
表示名と SMTP アドレスに加えて、豊富なプロパティセットを指定するroomおよびroomListの特定のエンティティを定義します。Defines the specific entities of room and roomList which specify a richer property set, in addition to the display name and SMTP address. 各会議室および会議室一覧には、表示名と SMTP アドレスのみを指定する、軽量化されたemailAddressの種類があります。Each room and room list is of a lighter weight emailAddress type which specifies only the display name and SMTP address
委任 (職場または学校のアカウント) またはアプリケーションのアクセス許可を持つ、組織のシナリオのみをサポートします。Supports only organizational scenarios with delegated (work or school accounts) or application permissions 委任されたアクセス許可またはアプリケーションのアクセス許可を持つ組織のシナリオに対して同様のサポートSimilar support for only organizational scenarios with delegated or application permissions
テナント内の個別の会議室または会議室一覧の更新をサポートしています。Supports updating an individual room or room list in a tenant テナント内の個々の会議室または会議室一覧の更新をサポートしていませんDoes not support updating an individual room or room list in a tenant

メソッドMethods

メソッドMethod 戻り値の型Return Type DescriptionDescription
プレースを一覧表示するList places 要求された派生型のコレクションA collection of the requested, derived type of place テナントで定義されている、指定された種類のプレースオブジェクトのコレクションを取得します。Get a collection of the specified type of place objects defined in the tenant.
場所を取得するGet place 要求された派生The requested, derived type of place 指定したplaceオブジェクトのプロパティとリレーションシップを取得します。Get the properties and relationships of a specified place object.
更新場所Update place 要求された派生The requested, derived type of place 指定したplaceオブジェクトのプロパティとリレーションシップを更新します。Update the properties and relationships of a specified place object.

プロパティProperties

プロパティProperty Type 説明Description
addressaddress physicalAddressphysicalAddress 場所の住所。The street address of the place.
displayNamedisplayName StringString 場所に関連付けられている名前。The name associated with the place.
geoCoordinatesgeoCoordinates outlookGeoCoordinatesoutlookGeoCoordinates 緯度、経度、および (オプションで) 高度座標での場所を指定します。Specifies the place location in latitude, longitude and (optionally) altitude coordinates.
idid 文字列String 場所の一意識別子。Unique identifier for the place. 読み取り専用です。Read-only.
phonephone StringString 場所の電話番号。The phone number of the place.

リレーションシップRelationships

なし。None.

JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

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

関連項目See also

  • 管理者が会議室一覧を作成するには、Exchange PowerShell コマンドレットの新しいグループを使用します。For administrators to create a room list, use the Exchange PowerShell cmdlet New-DistributionGroup.
  • 管理者が会議室一覧に会議室を追加するには、Exchange Powershell コマンドレットget-distributiongroupmemberを使用します。For administrators to add a room to a room list, use the Exchange Powershell cmdlet Add-DistributionGroupMember.