bookingAppointment 资源类型
命名空间:microsoft.graph
表示 bookingService 的客户约会,由Microsoft Bookings业务提供的一组员工执行。
注意
如果使用应用程序权限创建自定义应用,则必须遵循 业务规则验证。
方法
方法 | 返回类型 | 说明 |
---|---|---|
列出约会 | bookingAppointment 集合 | 获取指定 bookingbusiness 中的 bookingAppointment 对象列表。 |
创建 bookingAppointment | bookingAppointment | 为指定的 bookingbusiness 创建新的 bookingAppointment。 |
获取 bookingAppointment | bookingAppointment | 读取 bookingAppointment 对象的属性和关系。 |
更新 | 无 | 更新 bookingAppointment 对象。 |
删除 | 无 | 删除 bookingAppointment 对象。 |
Cancel | 无 | 取消 bookingAppointment 对象。 |
属性
属性 | 类型 | 说明 |
---|---|---|
additionalInformation | String | 确认约会时发送给客户的其他信息。 |
anonymousJoinWebUrl | String | 要匿名加入的会议 URL。 |
客户 | bookingCustomerInformation 集合 | 约会的客户属性集合。 约会包含客户信息列表,每个单元将指示属于该约会的客户的属性。 可选。 |
customerTimeZone | String | 客户的时区。 有关可能值的列表,请参阅 dateTimeTimeZone。 |
duration | 持续时间 | 约会的长度,以 ISO8601 格式表示。 |
endDateTime | dateTimeTimeZone | 约会结束的日期、时间和时区。 |
filledAttendeesCount | Int32 | 约会中的当前客户数 |
id | String | bookingAppointment 的 ID。 此为只读属性。 |
isLocationOnline | 布尔值 | 如果 true 为 ,则指示约会将联机举行。 默认值为 false 。 |
joinWebUrl | String | 约会的联机会议的 URL。 |
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。 仅当 maxAttendeeCount 为 1 时,才支持约会。 |
服务 Id | String | 与此约会关联的 bookingService 的 ID。 |
serviceLocation | location | 交付服务的位置。 |
serviceName | String | 与此约会关联的 bookingService 的名称。 创建新约会时,此属性是可选的。 如果未指定,则通过 serviceId 属性从与约会关联的服务中计算。 |
serviceNotes | String | bookingStaffMember 的备注。 仅当按 ID 读取此 bookingAppointment 时,此属性的值才可用。 |
smsNotificationsEnabled | 布尔值 | 如果 true 为 ,则指示将向客户发送预约的短信通知。 默认值为 false 。 |
staffMemberIds | 字符串集合 | 此约会中计划的每个 bookingStaffMember 的 ID。 |
startDateTime | dateTimeTimeZone | 约会开始的日期、时间和时区。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"additionalInformation": "String",
"anonymousJoinWebUrl": "String",
"customers": [
{
"@odata.type": "microsoft.graph.bookingCustomerInformation"
}
],
"duration": "String (timestamp)",
"endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"filledAttendeesCount": "Int32",
"id": "String (identifier)",
"isLocationOnline": "Boolean",
"joinWebUrl": "String",
"maximumAttendeesCount": "Int32",
"optOutOfCustomerEmail": "Boolean",
"postBuffer": "String (timestamp)",
"preBuffer": "String (timestamp)",
"price": "Double",
"priceType": {"@odata.type": "microsoft.graph.bookingPriceType"},
"reminders": [{"@odata.type": "microsoft.graph.bookingReminder"}],
"selfServiceAppointmentId": "String",
"serviceId": "String",
"serviceLocation": {"@odata.type": "microsoft.graph.location"},
"serviceName": "String",
"serviceNotes": "String",
"smsNotificationsEnabled": "Boolean",
"staffMemberIds": ["String"],
"startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈