Freigeben über


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.

Methoden

Methode Rückgabetyp Beschreibung
List bookingAppointment-Sammlung Ruft eine Liste der bookingAppointment-Objekte im angegebenen bookingBusiness ab.
Create bookingAppointment Erstellen Sie ein neues bookingAppointment für das angegebene bookingBusiness.
Get bookingAppointment Liest die Eigenschaften und Beziehungen des bookingAppointment-Objekts .
Update bookingAppointment Aktualisieren eines bookingAppointment-Objekts .
Delete Keine Löschen sie ein bookingAppointment-Objekt .
Termin absagen 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.
anonymousJoinWebUrl Zeichenfolge Die URL der Besprechung, an der anonym teilnehmen soll.
appointmentLabel Zeichenfolge Die benutzerdefinierte Bezeichnung, die für diesen Termin von Benutzern gestempelt werden kann.
createdDateTime DateTimeOffset Datum, Uhrzeit und Zeitzone, in der der Termin erstellt wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
customerEmailAddress Zeichenfolge Die SMTP-Adresse des bookingCustomer , der den Termin bucht.
customerName Zeichenfolge Der Name des Kunden.
customerNotes Zeichenfolge Notizen des Kunden, die diesem Termin zugeordnet sind. Sie können den Wert nur abrufen, wenn Sie dieses bookingAppointment anhand seiner ID lesen. Sie können diese Eigenschaft nur festlegen, wenn Sie zunächst einen Termin mit einem neuen Kunden erstellen.
customerPhone Zeichenfolge Die Telefonnummer des Kunden.
Kundschaft 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 Zeichenfolge 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.
end dateTimeTimeZone Das Datum, die Uhrzeit und die Zeitzone, in der der Termin endet.
filledAttendeesCount Int32 Die aktuelle Anzahl der Kunden im Termin.
id Zeichenfolge Die ID des bookingAppointment. Schreibgeschützt.
isCustomerAllowedToManageBooking Boolesch Gibt an, dass der Kunde buchungen verwalten kann, die vom Personal erstellt wurden. Der Standardwert ist false.
isLocationOnline Boolesch Gibt an, dass der Termin online gehalten wird. Der Standardwert ist false.
joinWebUrl Zeichenfolge Die URL der Onlinebesprechung für den Termin.
lastUpdatedDateTime DateTimeOffset Das Datum, die Uhrzeit und die Zeitzone, in der das Buchungsgeschäft zuletzt aktualisiert wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
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 Zeichenfolge Eine weitere Nachverfolgungs-ID für den Termin, wenn der Termin direkt vom Kunden auf der Terminplanungsseite und nicht von einem Mitarbeiter im Auftrag des Kunden erstellt wurde.
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 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 Zeichenfolge Notizen aus einem bookingStaffMember. Der Wert dieser Eigenschaft ist nur verfügbar, wenn diese bookingAppointment anhand seiner ID gelesen wird.
smsNotificationsEnabled Boolesch Gibt truean, dass SMS-Benachrichtigungen für den Termin an die Kunden gesendet werden. Der Standardwert ist false.
staffMemberIds Zeichenfolgensammlung Die ID jedes bookingStaffMember , der in diesem Termin geplant ist.
start dateTimeTimeZone Datum, Uhrzeit und Zeitzone, zu dem der Termin beginnt.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@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"}
}