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 zu aktualisierende Eigenschaften an. 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. |
| isCustomerAllowedToManageBooking | Boolesch | Gibt an, dass der Kunde buchungen verwalten kann, die vom Personal erstellt wurden. Der Standardwert ist false. |
| isHiddenFromCustomers | Boolesch |
True gibt an, dass der Dienst für Kunden nicht zur Buchung verfügbar ist. |
| isLocationOnline | Boolesch |
True gibt an, 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. Der Standardwert ist false. |
| staffMemberIds | Zeichenfolgensammlung | 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