bookingAppointment 资源类型

项目
07/31/2024

命名空间：microsoft.graph

表示 bookingService 的客户约会，由一组员工执行，由Microsoft Bookings 业务提供。

方法

方法	返回类型	Description
List	bookingAppointment 集合	获取指定 bookingBusiness 中的 bookingAppointment 对象列表。
创建	bookingAppointment	为指定的 bookingBusiness 创建新的 bookingAppointment。
Get	bookingAppointment	读取 bookingAppointment 对象的属性和关系。
更新	bookingAppointment	更新 bookingAppointment 对象。
删除	None	删除 bookingAppointment 对象。
取消约会	None	取消 bookingAppointment 对象。

属性

属性	类型	说明
additionalInformation	String	确认约会时发送给客户的其他信息。
anonymousJoinWebUrl	String	要匿名加入的会议 URL。
appointmentLabel	String	用户可以在此约会上标记的自定义标签。
createdDateTime	DateTimeOffset	创建约会时的日期、时间和时区。时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`。
customerEmailAddress	String	预订约会的 bookingCustomer 的 SMTP 地址。
customerName	String	客户的名称。
customerNotes	String	与此约会关联的客户的备注。仅当按 ID 读取此 bookingAppointment 时，才能获取该值。仅当最初与新客户创建约会时，才能设置此属性。
customerPhone	String	客户的电话号码。
客户	bookingCustomerInformation 集合	约会的客户属性集合。约会包含客户信息列表，每个单元将指示属于该约会的客户的属性。可选。
customerTimeZone	String	客户的时区。有关可能值的列表，请参阅 dateTimeTimeZone。
duration	持续时间	约会的长度，以 ISO8601 格式表示。
end	dateTimeTimeZone	约会结束时的日期、时间和时区。
filledAttendeesCount	Int32	约会中的当前客户数。
id	String	bookingAppointment 的 ID。此为只读属性。
isCustomerAllowedToManageBooking	布尔值	指示客户可以管理员工创建的预订。默认值为 `false`。
isLocationOnline	布尔值	指示约会联机举行。默认值为 `false`。
joinWebUrl	String	约会的联机会议的 URL。
lastUpdatedDateTime	DateTimeOffset	上次更新预订业务的日期、时间和时区。时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。例如，2014 年 1 月 1 日午夜 UTC 为 `2014-01-01T00:00:00Z`。
maximumAttendeesCount	Int32	约会中允许的最大客户数。如果服务的 maximumAttendeesCount 大于 1，请在创建或更新约会时传递有效的客户 ID。若要创建客户，请使用创建 bookingCustomer 操作。
optOutOfCustomerEmail	布尔值	如果 `true` 指示此约会的 bookingCustomer 不希望收到此约会的确认。
postBuffer	持续时间	约会结束后保留的时间量，例如清理时间。该值以 ISO8601 格式表示。
preBuffer	持续时间	例如，在约会开始前预留的时间量（用于准备）。该值以 ISO8601 格式表示。
价格	双精度	指定 bookingService 的约会的常规价格。
priceType	bookingPriceType	一个设置，用于为服务的定价结构提供灵活性。可取值为：`undefined`、`fixedPrice`、`startingAt`、`hourly`、`free`、`priceVaries`、`callUs`、`notSet`、`unknownFutureValue`。
提醒	bookingReminder 集合	为此约会发送的客户提醒集合。仅当按 ID 读取此 bookingAppointment 时，此属性的值才可用。
selfServiceAppointmentId	String	约会的另一个跟踪 ID（如果约会是由客户直接在计划页上创建的，而不是由代表客户的员工创建）。
服务 Id	String	与此约会关联的 bookingService 的 ID。
serviceLocation	location	交付服务的位置。
serviceName	String	与此约会关联的 bookingService 的名称。创建新约会时，此属性是可选的。如果未指定，则通过 serviceId 属性从与约会关联的服务中计算。
serviceNotes	String	bookingStaffMember 的备注。仅当按 ID 读取此 bookingAppointment 时，此属性的值才可用。
smsNotificationsEnabled	布尔值	如果 `true`为，则指示将向客户发送预约的短信通知。默认值为 `false`。
staffMemberIds	字符串集合	此约会中计划的每个 bookingStaffMember 的 ID。
start	dateTimeTimeZone	约会开始时的日期、时间和时区。

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.bookingAppointment",
  "additionalInformation": "String",
  "anonymousJoinWebUrl": "String",
  "appointmentLabel": "String",
  "createdDateTime": "String (timestamp)",
  "customerEmailAddress": "String",
  "customerName": "String",
  "customerNotes": "String",
  "customerPhone": "String",
  "customers": [{"@odata.type": "microsoft.graph.bookingCustomerInformation"}],
  "customerTimeZone": "String",
  "duration": "String (duration)",
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "filledAttendeesCount": "Int32",
  "id": "String (identifier)",
  "isCustomerAllowedToManageBooking": "Boolean",
  "isLocationOnline": "Boolean",
  "joinWebUrl": "String",
  "lastUpdatedDateTime": "String (timestamp)",
  "maximumAttendeesCount": "Int32",
  "optOutOfCustomerEmail": "Boolean",
  "postBuffer": "String (duration)",
  "preBuffer": "String (duration)",
  "price": "Double",
  "priceType": "String",
  "reminders": [{"@odata.type": "microsoft.graph.bookingReminder"}],
  "selfServiceAppointmentId": "String",
  "serviceId": "String",
  "serviceLocation": {"@odata.type": "microsoft.graph.location"},
  "serviceName": "String",
  "serviceNotes": "String",
  "smsNotificationsEnabled": "Boolean",
  "staffMemberIds": ["String"],
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}
}

通过

bookingAppointment 资源类型

方法

属性

关系

JSON 表示形式

反馈

其他资源