bookingBusinesses auflisten

Namespace: microsoft.graph

Dient zum Abrufen einer Sammlung von bookingBusiness-Objekten , die für den Mandanten erstellt wurden.

Dieser Vorgang gibt nur die ID und den displayName jedes Microsoft Bookings-Unternehmens in der Auflistung zurück. Aus Leistungsgründen werden keine anderen Eigenschaften zurückgegeben. Sie können die anderen Eigenschaften eines Bookings-Unternehmens abrufen, indem Sie dessen ID in einem GET-Vorgang angeben.

Berechtigungen

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.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Bookings.Read.All, BookingsAppointment.ReadWrite.All, Bookings.ReadWrite.All, Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	BookingsAppointment.ReadWrite.All, Bookings.Read.All

HTTP-Anforderung

GET /solutions/bookingBusinesses

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter $count und $expand, um die Antwort anzupassen.

Diese Methode unterstützt auch den Parameter, der query einen Zeichenfolgenwert akzeptiert. Dieser Parameter beschränkt die GET-Ergebnisse auf Unternehmen, die der angegebenen Zeichenfolge entsprechen. Weitere Informationen finden Sie im Beispiel.

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {code}

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und eine Sammlung von bookingBusiness-Objekten im Antworttext zurückgegeben.

Beispiele

Beispiel 1: Abrufen von Bookings-Unternehmen in einem Mandanten

Anforderung 1

Im folgenden Beispiel werden die Bookings-Unternehmen in einem Mandanten abzurufen.

GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses

Antwort 1

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context":"https://graph.microsoft.com/v1.0/solutions/$metadata#bookingBusinesses",
    "value":[
        {
            "id":"Contosolunchdelivery@contoso.onmicrosoft.com",
            "displayName":"Contoso lunch delivery",
        },
        {
            "id":"Fabrikam@contoso.onmicrosoft.com",
            "displayName":"Fabrikam",
        }
    ]
}

Beispiel 2: Verwenden von "Abfrage", um ein oder mehrere übereinstimmende Bookings-Unternehmen in einem Mandanten abzurufen

Anforderung 2

Das folgende Beispiel zeigt, wie Sie den query Parameter verwenden, um ein oder mehrere übereinstimmende Bookings-Unternehmen im Mandanten abzurufen.

GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses?query=Adventure

Antwort 2

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context":"https://graph.microsoft.com/v1.0/solutions/$metadata#bookingBusinesses",
    "value":[
        {
            "id":"AdventureWorksCycles@M365B960066.onmicrosoft.com",
            "displayName":"Adventure Works Cycles",
        }
    ]
}