Bookingservice aktualisierenUpdate bookingservice

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Aktualisieren der Eigenschaften eines bookingService -Objekts in der 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:The following are some examples you can customize for a service:

  • KursPrice
  • Typische Länge eines TerminsTypical length of an appointment
  • ErinnerungenReminders
  • Jeder Zeitpuffer, der vor oder nach Abschluss des Diensts eingerichtet werden sollAny time buffer to set up before or finish up after the service
  • Planen von Richtlinien Parametern wie minimaler Benachrichtigungswert für das buchen oder stornieren und ob Kunden bestimmte Mitarbeiter für einen Termin auswählen können.Scheduling policy parameters such as minimum notice to book or cancel, and whether customers can select specific staff members for an appointment.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Reservierungen. ReadWrite. all, reservations. Manage. allBookings.ReadWrite.All, Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

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

Optionale AnforderungsheaderOptional request headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {code}Bearer {code}

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
defaultDurationdefaultDuration DauerDuration Die Standardlänge des Diensts, der in Tagen, Stunden, Minuten und Sekunden dargestellt wird.The default length of the service, represented in numbers of days, hours, minutes, and seconds. Beispiel: p11d23h59m 59.999999999999 s.For example, P11D23H59M59.999999999999S.
defaultLocationdefaultLocation locationlocation Der standardmäßige physische Standort für den Dienst.The default physical location for the service.
defaultPricedefaultPrice Gleitkommawert mit doppelter GenauigkeitDouble Der standardmäßige monetäre Preis für den Dienst.The default monetary price for the service.
defaultPriceTypedefaultPriceType stringstring Die standardmäßige Art und Weise, in der der Dienst aufgeladen wird.The default way the service is charged. Mögliche Werte: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet.Possible values are: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet.
defaultRemindersdefaultReminders bookingReminder -SammlungbookingReminder collection Der standardmäßige mahnsatz für einen Termin dieses Diensts.The default set of reminders for an appointment of this service. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingService durch seine ID gelesen wird.The value of this property is available only when reading this bookingService by its ID.
descriptiondescription StringString Eine Textbeschreibung für den Dienst.A text description for the service.
displayNamedisplayName ZeichenfolgeString Ein Dienstname.A service name.
emailAddressemailAddress StringString Eine e-Mail-AdresseAn email address
idid ZeichenfolgeString Schreibgeschützt.Read-only.
isHiddenFromCustomersisHiddenFromCustomers BooleschBoolean True bedeutet, dass dieser Dienst Kunden nicht zur Buchung zur Verfügung steht.True means this service is not available to customers for booking.
notesnotes StringString Zusätzliche Informationen zu diesem Dienst.Additional information about this service.
postBufferpostBuffer DauerDuration Die Zeit, die nach einem Termin für diesen Dienst beendet wird, und bevor der nächste Kundentermin gebucht werden kann.The time to buffer after an appointment for this service ends, and before the next customer appointment can be booked.
preBufferpreBuffer DauerDuration Die Zeit bis zum Puffern, bevor ein Termin für diesen Dienst gestartet werden kann.The time to buffer before an appointment for this service can start.
schedulingPolicyschedulingPolicy bookingSchedulingPolicybookingSchedulingPolicy Die Gruppe von Richtlinien, die festlegen, wie Termine für diesen Diensttyp erstellt und verwaltet werden sollen.The set of policies that determine how appointments for this type of service should be created and managed.
staffMemberIdsstaffMemberIds String collectionString collection Stellt die Mitarbeiter dar, die diesen Dienst bereitstellen.Represents those staff members who provide this service.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No content zurückgegeben. Im Antworttext wird nichts zurückgegeben.If successful, this method returns a 204 No content response code. It does not return anything in the response body.

BeispielExample

AnforderungRequest

Im folgenden Beispiel wird die Dauer des angegebenen Diensts aktualisiert.The following example updates the duration of the specified service.

PATCH https://graph.microsoft.com/beta/bookingBusinesses/Contosolunchdelivery@M365B489948.onmicrosoft.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json

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

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

HTTP/1.1 204 No Content