Freigeben über

Verwenden der Microsoft Bookings-API in Microsoft Graph für freigegebene Buchungen

  • Artikel

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Mit Microsoft Bookings können Unternehmensorganisationen und Kleinunternehmer mit geringem Aufwand Kundenbuchungen und -informationen verwalten. Ein Geschäftsinhaber kann ein oder mehrere Unternehmen erstellen, wobei jedes Unternehmen ein eigenes Angebot an Diensten beinhaltet. Der Geschäftsinhaber kann Mitarbeiter einrichten und Dienste angeben, die jeder Mitarbeiter ausführt. Ein Kunde kann einen Termin für einen bestimmten Dienst in diesem Unternehmen entweder online oder über eine mobile App buchen. Mit Bookings wird sichergestellt, dass der Termin für das Unternehmen, die Mitarbeiter und die jeweils involvierten Kunden auf dem neuesten Stand ist.

Wichtig

Die Microsoft Bookings-API in Microsoft Graph gilt nur für freigegebene Buchungen. Die API gilt nicht für persönliche Buchungen.

Ein bookingBusiness-Objekt umfasst programmgesteuert in der Bookings-API die folgenden Objekte:

Verwenden der Bookings-REST-API

Führen Sie die folgenden Schritte aus, bevor Sie zum ersten Mal Kundentermine für ein Unternehmen buchen. Stellen Sie sicher, dass Sie die entsprechenden Zugriffstoken für die entsprechenden Vorgänge bereitstellen.

  1. Stellen Sie sicher, dass das Unternehmen über ein Microsoft 365 Business Premium-Abonnement verfügt.
  2. Erstellen Sie ein neues bookingBusiness-Objekt, indem Sie einen POST-Vorgang an die Entitätenmenge senden. Sie sollten mindestens einen Namen für das neue Unternehmen angeben, der Kunden angezeigt wird:
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.

  1. Fügen Sie einzelne Mitarbeiter für das Unternehmen hinzu:
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:
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:
POST https://graph.microsoft.com/beta/bookingBusinesses/{id}/publish
Authorization: Bearer {access token}

So können Sie generell alle Unternehmen mit Bookings im Microsoft 365-Mandanten auflisten:

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

Allgemeine Anwendungsfälle

Die folgende Tabelle enthält die allgemeinen Vorgänge für ein Unternehmen in der Bookings-API.

Anwendungsfälle REST-Ressourcen Siehe auch
Erstellen, Abrufen, Aktualisieren oder Löschen eines Unternehmens bookingBusiness Methoden von bookingBusiness
Aktualisieren der Richtlinie für die Terminvergabe bookingSchedulingPolicy Aktualisieren von bookingBusiness
Hinzufügen, Abrufen, Aktualisieren oder Löschen von Mitarbeitern bookingStaffMember Methoden von bookingStaffMember
Hinzufügen, Abrufen, Aktualisieren oder Löschen von Diensten bookingService Methoden von bookingService
Veröffentlichen oder Aufheben der Veröffentlichung der Seite für die Terminvergabe bookingBusiness publish
unpublish
Erstellen, Abrufen, Aktualisieren, Löschen oder Absagen von Terminen bookingAppointment Methoden von bookingAppointment
Abrufen von Terminen in einem Datumsbereich bookingBusiness Auflisten von Bookings für calendarView
Abrufen der Währung bookingCurrency Methoden von bookingCurrency

Verwandte Inhalte