Freigeben über


Buchungsservice aktualisieren

Namespace: microsoft.graph

Aktualisieren Sie die Eigenschaften eines bookingService-Objekts im angegebenen bookingBusiness.Update the properties of a bookingService object in the specified bookingBusiness.

Im Folgenden finden Sie einige Beispiele, die Sie für einen Dienst anpassen können:

  • Kurs
  • Typische Länge eines Termins
  • Erinnerungen
  • Jeder Zeitpuffer, der vor oder nach dem Dienst eingerichtet werden soll
  • Zeitplanungsrichtlinienparameter , z. B. Mindesthinweise zum Buchen oder Stornieren, und ob Kunden bestimmte Mitarbeiter für einen Termin auswählen können.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Bookings.ReadWrite.All Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Bookings.ReadWrite.All Bookings.Manage.All

HTTP-Anforderung

PATCH /solutions/bookingBusinesses/{id}/services/{id}

Anforderungsheader

Name Beschreibung
Authorization Bearer {code}. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die Eigenschaften an, 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
customQuestions bookingQuestionAssignment-Sammlung Dies enthält eine Reihe von benutzerdefinierten Fragen, die einem bestimmten Dienst zugeordnet sind. Optional.
defaultDuration Dauer Die Standardlänge des Diensts in Anzahl von Tagen, Stunden, Minuten und Sekunden. Beispiel: P11D23H59M59.999999999999999.
Defaultlocation location Der physische Standardspeicherort für den Dienst.
defaultPrice Gleitkommawert mit doppelter Genauigkeit Der Standardmäßige Geldpreis für den Dienst.
defaultPriceType bookingPriceType Die Standardgebühr für den Dienst. Mögliche Werte: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet, unknownFutureValue.
defaultReminders bookingReminder-Sammlung Der Standardsatz von Erinnerungen für einen Termin dieses Diensts. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingService anhand seiner ID gelesen wird.
description String Eine Textbeschreibung für den Dienst.
displayName String Ein Dienstname.
id String Der eindeutige Bezeichner für bookingService. Schreibgeschützt.
isAnonymousJoinEnabled Boolesch True , wenn die URL für die anonyme Teilnahme am Termin (anonymousJoinWebUrl) für den für diesen Dienst gebuchten Termin generiert wird.
isHiddenFromCustomers Boolesch Gibt an, truedass der Dienst für Kunden nicht zur Buchung verfügbar ist.
isLocationOnline Boolesch Wenn true dies darauf hinweist, dass die Termine für den Dienst online gehalten werden. Der Standardwert ist false.
languageTag String Die Sprache der Self-Service-Buchungsseite.
maximumAttendeesCount Int32 Die maximale Anzahl von Kunden, die in einem Dienst zulässig sind.
notes String Zusätzliche Informationen zu diesem Dienst.
postBuffer Dauer Die Zeit, die nach Ablauf eines Termins für diesen Dienst gepuffert werden muss und bevor der nächste Kundentermin gebucht werden kann.
preBuffer Dauer Die Zeit, die gepuffert werden soll, bevor ein Termin für diesen Dienst beginnen kann.
schedulingPolicy bookingSchedulingPolicy Der Satz von Richtlinien, die bestimmen, wie Termine für diesen Diensttyp erstellt und verwaltet werden sollen.
smsNotificationsEnabled Boolesch True gibt an, dass SMS-Benachrichtigungen zum Termin des Diensts an die Kunden gesendet werden können. Standardwert ist "false".
staffMemberIds String collection Stellt die Mitarbeiter dar , die diesen Dienst bereitstellen.

Antwort

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

Beispiel

Anforderung

Im folgenden Beispiel wird die Dauer des angegebenen Diensts aktualisiert.

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingService",
    "defaultDuration":"PT30M"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content