Тип ресурса bookingAppointment
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Представляет встречу клиента для bookingService, выполняемую набором сотрудников, предоставленных Microsoft Bookings компании.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Список | коллекция bookingAppointment | Получите список объектов bookingAppointment в указанном bookingbusiness. |
| Создание | bookingAppointment | Создайте новый bookingAppointment для указанного bookingbusiness. |
| Получение | bookingAppointment | Чтение свойств и связей объекта bookingAppointment . |
| Обновление | bookingAppointment | Обновление объекта bookingAppointment . |
| удаление; | Нет | Удаление объекта bookingAppointment . |
| Отмена встречи | Нет | Отмена объекта bookingAppointment . |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| additionalInformation | String | Дополнительные сведения, которые отправляются клиенту при подтверждении встречи. |
| anonymousJoinWebUrl | String | URL-адрес собрания для анонимного присоединения. |
| appointmentLabel | String | Пользователь может пометить пользовательскую метку на встрече. |
| createdDateTime | DateTimeOffset | Дата, время и часовой пояс, когда была создана встреча. |
| customerEmailAddress | String | SMTP-адрес bookingCustomer , который резервит встречу. |
| customerId | String | Идентификатор bookingCustomer для этой встречи. Если при создании встречи не указан идентификатор, создается новый объект bookingCustomer . После установки следует считать customerId неизменяемым. |
| customerLocation | location | Представляет сведения о местоположении для bookingCustomer , который резервирует встречу. |
| customerName | String | Имя клиента. |
| customerNotes | String | Заметки от клиента, связанного с этой встречей. Значение можно получить только при чтении этого объекта bookingAppointment по его идентификатору. Это свойство можно задать только при первоначальном создании встречи с новым клиентом. |
| customerPhone | String | Номер телефона клиента. |
| Клиентов | коллекция bookingCustomerInformation | Коллекция свойств клиента для встречи. Встреча будет содержать список сведений о клиентах, и каждая единица будет указывать свойства клиента, который является частью этой встречи. Необязательный параметр. |
| customerTimeZone | String | Часовой пояс клиента. Список возможных значений см. в разделе dateTimeTimeZone. |
| duration | Duration (Длительность) | Длина встречи, обозначенная в ISO8601 формате. |
| end | dateTimeTimeZone | Дата, время и часовой пояс окончания встречи. |
| filledAttendeesCount | Int32 | Текущее число клиентов в встрече. |
| id | String | Идентификатор bookingAppointment. Только для чтения. |
| invoiceAmount | Двойное с плавающей точкой | Сумма счета в счете. |
| invoiceDate | dateTimeTimeZone | Дата, время и часовой пояс счета для этой встречи. |
| invoiceId | String | Идентификатор счета. |
| invoiceStatus | string | Состояние счета. Возможные значения: draft, reviewing, open, canceled, paid, corrective. |
| invoiceUrl | String | URL-адрес счета в Microsoft Bookings. |
| isCustomerAllowedToManageBooking | Логический | Указывает, что клиент может управлять заказами, созданными сотрудниками. Значение по умолчанию — false. |
| isLocationOnline | Логический | Указывает, что встреча проводится в режиме онлайн. Значение по умолчанию — false. |
| joinWebUrl | String | URL-адрес собрания по сети для встречи. |
| lastUpdatedDateTime | DateTimeOffset | Дата, время и часовой пояс последнего обновления компании бронирования. |
| maximumAttendeesCount | Int32 | Максимальное число клиентов, разрешенное в встрече. Если параметр maximumAttendeesCount службы больше 1, передайте действительные идентификаторы клиентов при создании или обновлении встречи. Чтобы создать клиента, используйте операцию Создать bookingCustomer . |
| optOutOfCustomerEmail | Логический | Значение True указывает, что bookingCustomer для этой встречи не хочет получать подтверждение для этой встречи. |
| postBuffer | Duration (Длительность) | Количество времени, которое необходимо зарезервировать после окончания встречи для очистки, в качестве примера. Значение выражается в формате ISO8601 . |
| preBuffer | Duration (Длительность) | Количество времени, которое необходимо зарезервировать до начала встречи для подготовки, в качестве примера. Значение выражается в формате ISO8601 . |
| цена | Двойное с плавающей точкой | Обычная цена за встречу для указанной bookingService. |
| priceType | bookingPriceType | Параметр, обеспечивающий гибкость структуры ценообразования служб. Возможные значения: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet, unknownFutureValue. |
| Напоминания | коллекция bookingReminder | Коллекция напоминаний клиентов, отправленных для этой встречи. Значение этого свойства доступно только при чтении этого объекта bookingAppointment по его идентификатору. |
| selfServiceAppointmentId | String | Другой идентификатор отслеживания для встречи, если встреча была создана непосредственно клиентом на странице планирования, а не сотрудником от имени клиента. |
| serviceId | Строка | Идентификатор bookingService , связанного с этой встречей. |
| serviceLocation | location | Расположение, в котором доставляется служба. |
| serviceName | String | Имя службы bookingService , связанной с этой встречей. Это свойство является необязательным при создании новой встречи. Если он не указан, он вычисляется из службы, связанной с встречей, с помощью свойства serviceId . |
| serviceNotes | String | Заметки из bookingStaffMember. Значение этого свойства доступно только при чтении этого объекта bookingAppointment по его идентификатору. |
| smsNotificationsEnabled | Логический | Значение True указывает, что клиентам будут отправляться SMS-уведомления о встрече. Значение по умолчанию − ложь. |
| staffMemberIds | Коллекция строк | Идентификатор каждого bookingStaffMember , запланированного на эту встречу. |
| начать | dateTimeTimeZone | Дата, время и часовой пояс, с которыми начинается встреча. |
Связи
Нет
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"@odata.type": "#microsoft.graph.bookingAppointment",
"id": "String (identifier)",
"createdDateTime": "String (timestamp)",
"lastUpdatedDateTime": "String (timestamp)",
"selfServiceAppointmentId": "String",
"additionalInformation": "String",
"appointmentLabel": "String",
"isLocationOnline": "Boolean",
"joinWebUrl": "String",
"smsNotificationsEnabled": "Boolean",
"customerId": "String",
"customerName": "String",
"customerEmailAddress": "String",
"customerPhone": "String",
"customerLocation": {
"@odata.type": "microsoft.graph.location"
},
"customerTimeZone": "String",
"customerNotes": "String",
"serviceId": "String",
"serviceName": "String",
"start": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"end": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"duration": "String (duration)",
"preBuffer": "String (duration)",
"postBuffer": "String (duration)",
"serviceLocation": {
"@odata.type": "microsoft.graph.location"
},
"priceType": "String",
"price": "Double",
"serviceNotes": "String",
"reminders": [
{
"@odata.type": "microsoft.graph.bookingReminder"
}
],
"optOutOfCustomerEmail": "Boolean",
"anonymousJoinWebUrl": "String",
"customers": [
{
"@odata.type": "microsoft.graph.bookingCustomerInformation"
}
],
"maximumAttendeesCount": "Int32",
"filledAttendeesCount": "Int32",
"staffMemberIds": [
"String"
],
"invoiceAmount": "Double",
"invoiceDate": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"invoiceId": "String",
"invoiceStatus": "String",
"invoiceUrl": "String",
"isCustomerAllowedToManageBooking": "Boolean",
}