Location リソースの種類Location resource type

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


/betaMicrosoft Graph のバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported. API が v2.0 で利用できるかどうかを確認するには、 バージョン セレクターを使用します。To determine whether an API is available in v1.0, use the Version selector.

イベントの場所の情報を表します。Represents location information of an event.

カレンダー内にイベントを作成するには、複数の方法があります。たとえば、アプリでイベント作成 REST API を使用するという方法、Outlook ユーザー インターフェイスを手動で使用するという方法などです。There are multiple ways to create events in a calendar, for example, through an app using the create event REST API, or manually using the Outlook user interface. ユーザー インターフェイスを使用してイベントを作成する場合は、場所をプレーン テキストとして指定することも、Outlook、Bing Autosuggest、または Bing ローカル検索で提供される会議室リストから選択して指定することもできます。When you create an event using the user interface, you can specify the location as plain text (for example, "Harry's Bar"), or from the rooms list provided by Outlook, Bing Autosuggest, or Bing local search.

イベントの作成方法によって、Outlook は読み取り専用の locationType プロパティを異なる方法で設定します。Depending on how an event is created, expect Outlook to set the read-only locationType property differently.

イベントの作成方法How event was created プロパティProperty 予期される値Expected value
イベント作成 REST APIcreate event REST API locationTypelocationType default
Outlook のユーザー インターフェイスUser interface in Outlook locationTypelocationType 以下のいずれか:One of the following:
  • プレーン テキストとして入力された場所の場合は defaultdefault for a location entered as plain text.
  • Outlook の会議室リストで提供された会議室の場合は conferenceRoomconferenceRoom for a room provided by the Outlook rooms list.
  • Bing Autosuggest または Bing ローカル検索による場所の場合は、homeAddressbusinessAddressgeoCoordinatesstreetAddresshotelrestaurantlocalBusinesspostalAddress のいずれか。Or, any of this list - homeAddress, businessAddress,geoCoordinates, streetAddress, hotel, restaurant, localBusiness, postalAddress - for a location from Bing Autosuggest or Bing local search.


プロパティProperty Type 説明Description
addressaddress physicalAddressphysicalAddress 場所の番地。The street address of the location.
coordinatescoordinates outlookGeoCoordinatesoutlookGeoCoordinates 場所の地理的座標と標高。The geographic coordinates and elevation of the location.
displayNamedisplayName StringString 場所に関連付けられた名前。The name associated with the location.
locationEmailAddresslocationEmailAddress StringString 場所のメール アドレス (省略可能)。Optional email address of the location.
locationUrilocationUri StringString 場所を表す URI (省略可能)。Optional URI representing the location.
locationTypelocationType locationTypelocationType 場所の種類。The type of location. 可能な値は、defaultconferenceRoomhomeAddressbusinessAddressgeoCoordinatesstreetAddresshotelrestaurantlocalBusinesspostalAddress です。Possible values are: default, conferenceRoom, homeAddress, businessAddress,geoCoordinates, streetAddress, hotel, restaurant, localBusiness, postalAddress. 読み取り専用。Read-only.
uniqueIduniqueId StringString 内部使用のみ。For internal use only.
uniqueIdTypeuniqueIdType StringString 内部使用のみ。For internal use only.

JSON 表記JSON representation

  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "coordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "displayName": "string",
  "locationEmailAddress": "string",
  "locationType": "string",
  "locationUri": "string",
  "uniqueId": "string",
  "uniqueIdType": "string"