bookingAppointment-Ressourcentyp
Namespace: microsoft.graph
Stellt einen Kundentermin für einen bookingService dar, der von einer Gruppe von Mitarbeitern durchgeführt wird, die von einem Microsoft Bookings Unternehmen bereitgestellt werden.
Hinweis
Wenn Sie eine benutzerdefinierte App mit Anwendungsberechtigungen erstellen, müssen Sie die Überprüfung der Geschäftsregeln befolgen.
Methoden
Methode | Rückgabetyp | Beschreibung |
---|---|---|
Termine auflisten | bookingAppointment-Sammlung | Ruft 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 | Liest die Eigenschaften und Beziehungen des bookingAppointment-Objekts . |
Update | Keine | Aktualisieren eines bookingAppointment-Objekts . |
Delete | Keine | Löschen sie ein bookingAppointment-Objekt . |
Cancel | Keine | Stornieren eines bookingAppointment-Objekts . |
Eigenschaften
Eigenschaft | Typ | Beschreibung |
---|---|---|
additionalInformation | String | Zusätzliche Informationen, die an den Kunden gesendet werden, wenn ein Termin bestätigt wird. |
anonymousJoinWebUrl | String | Die URL der Besprechung, an der anonym teilnehmen soll. |
Kunden | bookingCustomerInformation-Sammlung | Eine Auflistung von Kundeneigenschaften für einen Termin. Ein Termin enthält eine Liste mit Kundeninformationen, und jede Einheit gibt die Eigenschaften eines Kunden an, der Teil dieses Termins ist. Optional. |
customerTimeZone | String | Die Zeitzone des Kunden. Eine Liste der möglichen Werte finden Sie unter dateTimeTimeZone. |
Dauer | Dauer | Die Länge des Termins, die im format ISO8601 angegeben ist. |
endDateTime | dateTimeTimeZone | Datum, Uhrzeit und Zeitzone, in der der Termin endet. |
filledAttendeesCount | Int32 | Die aktuelle Anzahl der Kunden im Termin |
id | String | Die ID des bookingAppointment. Schreibgeschützt. |
isLocationOnline | Boolesch | Gibt true an, dass der Termin online gehalten wird. Der Standardwert ist false . |
joinWebUrl | String | 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 beim Erstellen oder Aktualisieren eines Termins gültige Kunden-IDs. Verwenden Sie zum Erstellen eines Kunden den Vorgang bookingCustomer erstellen . |
optOutOfCustomerEmail | Boolesch | Wenn true angibt, dass der bookingCustomer für diesen Termin keine Bestätigung für diesen Termin erhalten möchte. |
postBuffer | Dauer | Die Zeit, die nach Ablauf des Termins reserviert werden soll, z. B. für die Bereinigung. Der Wert wird in ISO8601 Format ausgedrückt. |
preBuffer | Dauer | Die Zeit, die vor Beginn des Termins reserviert werden muss, z. B. zur Vorbereitung. Der Wert wird in 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 diese bookingAppointment anhand seiner ID gelesen wird. |
selfServiceAppointmentId | String | Eine zusätzliche Nachverfolgungs-ID für den Termin, wenn der Termin direkt vom Kunden auf der Terminplanungsseite und nicht von einem Mitarbeiter im Namen des Kunden erstellt wurde. 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 | String | Der Name des bookingService , der diesem Termin zugeordnet ist. Diese Eigenschaft ist beim Erstellen eines neuen Termins optional. Wenn keine Angabe erfolgt, wird sie aus dem Dienst berechnet, der dem Termin durch die serviceId-Eigenschaft zugeordnet ist. |
serviceNotes | String | Notizen aus einem bookingStaffMember. Der Wert dieser Eigenschaft ist nur verfügbar, wenn diese bookingAppointment anhand seiner ID gelesen wird. |
smsNotificationsEnabled | Boolesch | Gibt true an, dass SMS-Benachrichtigungen für den Termin an die Kunden gesendet werden. Der Standardwert ist false . |
staffMemberIds | String collection | Die ID jedes bookingStaffMember , der in diesem Termin geplant ist. |
startDateTime | dateTimeTimeZone | Datum, Uhrzeit und Zeitzone, in der der Termin beginnt. |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"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"}
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für