位置资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示事件的位置信息。

可采用多种方法在日历中创建事件,例如,通过应用使用 create event REST API,或者手动使用 Outlook 用户界面。 在使用用户界面创建事件时,可以以纯文本格式(例如,“Harry's Bar”)指定位置,或者从 Outlook 提供的会议室列表、必应自动建议或必应本地搜索中指定位置。

根据事件的创建方式,Outlook 应以不同方式设置只读 locationType 属性。

事件的创建方式 属性 预期值
create event REST API locationType default
Outlook 中的用户界面 locationType 以下各项之一:
  • default,以纯文本格式输入的位置。
  • conferenceRoom,Outlook 会议室列表提供的会议室。
  • 或者,该列表中的任意项:homeAddressbusinessAddressgeoCoordinatesstreetAddresshotelrestaurantlocalBusinesspostalAddress,必应自动建议或必应本地搜索中的位置。

属性

属性 类型 说明
address physicalAddress 位置的街道地址。
coordinates outlookGeoCoordinates 地理坐标和位置的海拔高度。
displayName String 与地点相关联的名称。
locationEmailAddress String (可选)与位置相关联的电子邮件地址。
locationUri String (可选)表示位置的 URI。
locationType locationType 位置的类型。 可取值为:defaultconferenceRoomhomeAddressbusinessAddressgeoCoordinatesstreetAddresshotelrestaurantlocalBusinesspostalAddress。 只读。
uniqueId String 仅供内部使用。
uniqueIdType String 仅供内部使用。

JSON 表示形式

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