Verwenden der Microsoft Bookings-API in Microsoft GraphUse the Microsoft Bookings API in Microsoft Graph

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.

Mit Microsoft Bookings können Kleinunternehmer mit geringem Aufwand Kundenbuchungen und -informationen verwalten.Microsoft Bookings lets small business owners manage customer bookings and information with minimal setup. Ein Geschäftsinhaber kann ein oder mehrere Unternehmen erstellen, wobei jedes Unternehmen ein eigenes Angebot an Diensten beinhaltet.A business owner can create one or more businesses, with each business offering a set of services. Der Geschäftsinhaber kann Mitarbeiter einrichten und Dienste angeben, die jeder Mitarbeiter ausführt.The owner can set up staff members, and specify the services that each staff member performs. Ein Kunde kann einen Termin für einen bestimmten Dienst in diesem Unternehmen entweder online oder über eine mobile App buchen.A customer can book an appointment for a specific service in that business in an online or mobile app. Mit Bookings wird sichergestellt, dass der Termin für das Unternehmen, die Mitarbeiter und die jeweils involvierten Kunden auf dem neuesten Stand ist.Bookings ensures that the appointment time is kept up-to-date for the business, staff members, and customers involved.

Ein bookingBusiness-Objekt umfasst programmgesteuert in der Bookings-API die folgenden Objekte:Programmatically, a bookingBusiness in the Bookings API involves the following objects:

Verwenden der Bookings-REST-APIUsing the Bookings REST API

Führen Sie die folgenden Schritte aus, bevor Sie zum ersten Mal Kundentermine für ein Unternehmen buchen.Walk through the following steps before booking customer appointments for a business the first time. Stellen Sie sicher, dass Sie die entsprechenden Zugriffstoken für die entsprechenden Vorgänge bereitstellen.Make sure you provide the appropriate access tokens for the corresponding operations.

  1. Stellen Sie sicher, dass das Unternehmen über ein Office 365 Business Premium-Abonnement verfügt.Make sure the business has an Office 365 Business Premium subscription.
  2. Erstellen Sie ein neues bookingBusiness-Objekt, indem Sie einen POST-Vorgang an die Entitätenmenge senden.Create a new bookingBusiness by sending a POST operation to the entity set. Sie sollten mindestens einen Namen für das neue Unternehmen angeben, der Kunden angezeigt wird:At minimum, you should specify a name for the new business that customers will see:
POST https://graph.microsoft.com/beta/bookingBusinesses
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Contoso"
}

Verwenden Sie die id-Eigenschaft des neuen bookingBusiness-Objekts, das in der POST-Antwort zurückgegeben wurde, um mit dem Anpassen der Unternehmenseinstellungen fortzufahren, und fügen Sie Mitarbeiter und Dienste für das Unternehmen hinzu.Use the id property of the new bookingBusiness returned in the POST response to continue to customize business settings, and add staff members and services for the business.

  1. Fügen Sie einzelne Mitarbeiter für das Unternehmen hinzu:Add individual staff members for the business:
POST https://graph.microsoft.com/beta/bookingBusinesses/{id}/staffMembers
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Dana Swope",
    "emailAddress": "danas@contoso.com",
    "role": "externalGuest"
}
  1. Definieren Sie jeden Dienst, der vom Unternehmen angeboten wird:Define each service offered by the business:
POST https://graph.microsoft.com/beta/bookingBusinesses/{id}/services
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Bento"
}
  1. Veröffentlichen Sie die Seite für die Terminvergabe für das Unternehmen, damit Kunden und Betreiber des Unternehmens Termine buchen können:Publish the scheduling page for the business, to let customers and business operators start booking appointments:
POST https://graph.microsoft.com/beta/bookingBusinesses/{id}/publish
Authorization: Bearer {access token}

So können Sie generell alle Unternehmen mit Bookings im Office 365-Mandanten auflisten:In general, to list all the booking businesses in the Office 365 tenant:

GET https://graph.microsoft.com/beta/bookingBusinesses
Authorization: Bearer {access token}

Allgemeine AnwendungsfälleCommon use cases

Die folgende Tabelle enthält die allgemeinen Vorgänge für ein Unternehmen in der Bookings-API.The following table lists the common operations for a business in the Bookings API.

AnwendungsfälleUse cases REST-RessourcenREST resources Siehe auchSee also
Erstellen, Abrufen, Aktualisieren oder Löschen eines UnternehmensCreate, get, update, or delete a business bookingBusinessbookingBusiness Methoden von bookingBusinessMethods of bookingBusiness
Aktualisieren der Richtlinie für die TerminvergabeUpdate the scheduling policy bookingSchedulingPolicybookingSchedulingPolicy Aktualisieren von bookingBusinessUpdate a bookingBusiness
Hinzufügen, Abrufen, Aktualisieren oder Löschen von MitarbeiternAdd, get, update, or delete staff members bookingStaffMemberbookingStaffMember Methoden von bookingStaffMemberMethods of bookingStaffMember
Hinzufügen, Abrufen, Aktualisieren oder Löschen von DienstenAdd, get, update, or delete services bookingServicebookingService Methoden von bookingServiceMethods of bookingService
Veröffentlichen oder Aufheben der Veröffentlichung der Seite für die TerminvergabePublish or unpublish the scheduling page bookingBusinessbookingBusiness publishpublish
unpublishunpublish
Erstellen, Abrufen, Aktualisieren, Löschen oder Absagen von TerminenCreate, get, update, delete, or cancel an appointment bookingAppointmentbookingAppointment Methoden von bookingAppointmentMethods of bookingAppointment
Abrufen von Terminen in einem DatumsbereichGet appointments in a date range bookingBusinessbookingBusiness Auflisten von Bookings für calendarViewList Bookings calendarView
Abrufen der WährungGet currency bookingCurrencybookingCurrency Methoden von bookingCurrencyMethods of bookingCurrency

Siehe auchSee also