Bookingbusiness aktualisierenUpdate bookingbusiness

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 bookingBusiness -Objekts.Update the properties of a bookingBusiness object.

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}

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
addressaddress physicalAddressphysicalAddress Die Anschrift des Unternehmens.The street address of the business.
businessHoursbusinessHours bookingWorkHours -SammlungbookingWorkHours collection Die Betriebsstunden für das Unternehmen.The hours of operation for the business.
businesstypebusinessType StringString Der Typ des Unternehmens.The type of business.
defaultCurrencyIsodefaultCurrencyIso StringString Der Code für die Währung, in der das Unternehmen in Microsoft-Buchungen tätig ist.The code for the currency that the business operates in on Microsoft Bookings.
displayNamedisplayName ZeichenfolgeString Ein Name für das Unternehmen, der mit Kunden Schnittstellen.A name for the business that interfaces with customers.
emailemail StringString Die e-Mail-Adresse für das Unternehmen.The email address for the business.
phonephone StringString Die Telefonnummer für das Unternehmen.The telephone number for the business.
schedulingPolicyschedulingPolicy bookingSchedulingPolicybookingSchedulingPolicy Gibt an, wie Buchungen für dieses Unternehmen erstellt werden können.Specifies how bookings can be created for this business.
webSiteUrlwebSiteUrl StringString Die URL der Geschäftswebsite.The URL of the business web site.

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 werden die Geschäfts-e-Mail-Adresse und die Terminplan Richtlinie aktualisiert, um das standardmäßige Buchungszeit Intervall für Unternehmen auf eine Stunde und eine Voranmeldung bis zu 30 Tage zu ändern.The following example updates the business email address and scheduling policy, to change the business default booking time slot to an hour, and advance booking up to 30 days.

PATCH https://graph.microsoft.com/beta/bookingBusinesses/fabrikam@M365B489948.onmicrosoft.com
Content-type: application/json

{
  "email": "admin@fabrikam.com",
  "schedulingPolicy": {
      "timeSlotInterval": "PT60M",
      "minimumLeadTime": "P1D",
      "maximumAdvance": "P30D",
      "sendConfirmationsToOwner": true,
      "allowStaffSelection": true
  }
}
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.All of the properties will be returned from an actual call.

HTTP/1.1 204 No Content