bookingAppointment aktualisieren

Namespace: microsoft.graph

Dient zum Aktualisieren der Eigenschaften eines bookingAppointment-Objekts im angegebenen bookingBusiness.Update the properties of a bookingAppointment object in the specified bookingBusiness.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	BookingsAppointment.ReadWrite.All, Bookings.ReadWrite.All, Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	BookingsAppointment.ReadWrite.All, Bookings.Read.All

Hinweis

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

HTTP-Anforderung

PATCH /solutions/bookingBusinesses/{id}/appointments/{id}

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {code}. Erforderlich.

Anforderungstext

Stellen Sie im Anforderungstext nur die Werte für Eigenschaften bereit, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft	Typ	Beschreibung
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. Erforderlich.
isLocationOnline	Boolescher Wert	If true, indicates that the appointment will be held online. Standardwert ist "false".
maximumAttendeesCount	Int32	Die maximale Anzahl von Kunden, die im Termin zulässig sind. Erforderlich.
optOutOfCustomerEmail	Boolesch	If true, indicates that the bookingCustomer for this appointment does not wish to receive a confirmation for this appointment.
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	Boolean	If true, indicates SMS notifications will be sent to the customers for the appointment. Standardwert ist "false".
staffMemberIds	Zeichenfolgensammlung	Die ID jedes bookingStaffMembers , der in diesem Termin geplant ist.
startDateTime	dateTimeTimeZone	Das Datum, die Uhrzeit und die Zeitzone, mit der der Termin beginnt.

Hinweis

Wenn die maximal zulässige Anzahl von Kunden (maximumAttedeesCount) im Dienst größer als 1 ist:

• Stellen Sie sicher, dass die Kunden im Buchungskalender vorhanden sind. Andernfalls erstellen Sie mithilfe des Vorgangs "bookingCustomer erstellen ".
• Übergeben Sie gültige Kunden-IDs, wenn Sie den Termin erstellen oder aktualisieren. Wenn die Kunden-ID ungültig ist, wird dieser Kunde nicht in das Terminobjekt eingeschlossen.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Im Antworttext wird nichts zurückgegeben.

Beispiele

Anforderung

Im folgenden Beispiel wird das Datum des Diensts um einen Tag geändert.

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/appointments/AAMkADKnAAA=
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingAppointment",
    "endDateTime":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:30:00.0000000+00:00",
        "timeZone":"UTC"
    },
    "startDateTime":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:00:00.0000000+00:00",
        "timeZone":"UTC"
    }
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 204 No Content