bookingAppointment-Ressourcentyp

Namespace: microsoft.graph

Stellt einen Kundentermin für einen bookingService dar, der von einer Gruppe von Mitarbeitern ausgeführt wird, die von einem Microsoft Bookings Unternehmen bereitgestellt wird.

Hinweis

Wenn Sie eine benutzerdefinierte App mithilfe von Anwendungsberechtigungen erstellen, müssen Sie die Überprüfung der Geschäftsregeln befolgen.

Methoden

Methode	Rückgabetyp	Beschreibung
Termine auflisten	bookingAppointment-Sammlung	Rufen Sie eine Liste der bookingAppointment-Objekte im angegebenen bookingbusiness ab.
bookingAppointment erstellen	bookingAppointment	Erstellen Sie ein neues bookingAppointment für das angegebene bookingbusiness.
bookingAppointment abrufen	bookingAppointment	Lesen sie die Eigenschaften und Beziehungen des bookingAppointment-Objekts .
Update	bookingAppointment	Aktualisieren eines bookingAppointment-Objekts .
Delete	Keine	Löschen eines bookingAppointment-Objekts .
Cancel	Keine	Stornieren eines bookingAppointment-Objekts .

Eigenschaften

Eigenschaft	Typ	Beschreibung
additionalInformation	Zeichenfolge	Zusätzliche Informationen, die an den Kunden gesendet werden, wenn ein Termin bestätigt wird.
Kunden	bookingCustomerInformation-Sammlung	Es listet die Kundeneigenschaften für einen Termin auf. Ein Termin enthält eine Liste mit Kundeninformationen, und jede Einheit gibt die Eigenschaften eines Kunden an, der Teil dieses Termins ist. Optional.
customerTimeZone	Zeichenfolge	Die Zeitzone des Kunden. Eine Liste der möglichen Werte finden Sie unter dateTimeTimeZone.
Dauer	Dauer	Die Länge des Termins im ISO8601-Format .
endDateTime	dateTimeTimeZone	Das Datum, die Uhrzeit und die Zeitzone, mit der der Termin endet.
filledAttendeesCount	Int32	Die aktuelle Anzahl der Kunden im Termin
id	Zeichenfolge	Die ID des bookingAppointment.The ID of the bookingAppointment. Schreibgeschützt.
isLocationOnline	Boolesch	If true, indicates that the appointment will be held online. Der Standardwert ist false.
joinWebUrl	Zeichenfolge	Die URL der Onlinebesprechung für den Termin.
maximumAttendeesCount	Int32	Die maximale Anzahl von Kunden, die in einem Termin zulässig sind. Wenn maximumAttendeesCount des Diensts größer als 1 ist, übergeben Sie gültige Kunden-IDs beim Erstellen oder Aktualisieren eines Termins. Verwenden Sie zum Erstellen eines Kunden den Vorgang "bookingCustomer erstellen ".
optOutOfCustomerEmail	Boolean	Wenn true angegeben, dass der bookingCustomer für diesen Termin keine Bestätigung für diesen Termin erhalten möchte.
postBuffer	Dauer	Die Zeitdauer, die nach Ablauf des Termins für die Bereinigung reserviert werden muss, als Beispiel. Der Wert wird im ISO8601-Format ausgedrückt.
preBuffer	Dauer	Der Zeitraum, der reserviert werden muss, bevor der Termin beginnt, als Beispiel für die Vorbereitung. Der Wert wird im ISO8601-Format ausgedrückt.
Preis	Gleitkommawert mit doppelter Genauigkeit	Der reguläre Preis für einen Termin für den angegebenen bookingService.
priceType	bookingPriceType	Eine Einstellung, die Flexibilität für die Preisstruktur von Diensten bietet. Mögliche Werte: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet, unknownFutureValue.
Erinnerungen	bookingReminder-Sammlung	Die Sammlung von Kundenerinnerungen, die für diesen Termin gesendet wurden. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingAppointment anhand seiner ID gelesen wird.
selfServiceAppointmentId	String	Eine zusätzliche Tracking-ID für den Termin, wenn der Termin direkt vom Kunden auf der Terminplanungsseite erstellt wurde, im Gegensatz zu einem Mitarbeiter im Auftrag des Kunden. Wird nur für Termin unterstützt, wenn maxAttendeeCount 1 ist.
ServiceID	Zeichenfolge	Die ID des bookingService, der diesem Termin zugeordnet ist.
serviceLocation	location	Der Ort, an dem der Dienst bereitgestellt wird.
Servicename	Zeichenfolge	Der Name des bookingService, der diesem Termin zugeordnet ist. Diese Eigenschaft ist optional beim Erstellen eines neuen Termins. Wenn nicht angegeben, wird es aus dem Dienst berechnet, der dem Termin durch die eigenschaft serviceId zugeordnet ist.
serviceNotes	Zeichenfolge	Notizen von einem bookingStaffMember. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingAppointment anhand seiner ID gelesen wird.
smsNotificationsEnabled	Boolescher Wert	If true, indicates SMS notifications will be sent to the customers for the appointment. Der Standardwert ist false.
staffMemberIds	String-Sammlung	Die ID jedes bookingStaffMembers , der in diesem Termin geplant ist.
startDateTime	dateTimeTimeZone	Das Datum, die Uhrzeit und die Zeitzone, mit der der Termin beginnt.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "customers": [
    {
      "@odata.type": "microsoft.graph.bookingCustomerInformation"
    }
  ],
  "duration": "String (timestamp)",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "id": "String (identifier)",
  "isLocationOnline": "Boolean",
  "joinWebUrl": "String",
  "optOutOfCustomerEmail": "Boolean",
  "postBuffer": "String (timestamp)",
  "preBuffer": "String (timestamp)",
  "price": "Integer",
  "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"},
  "maximumAttendeesCount": "Integer",
  "filledAttendeesCount": "Integer"
}