BookingBusinesses auflistenList bookingBusinesses

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.

Rufen Sie eine Auflistung von bookingbusiness -Objekten ab, die für den Mandanten erstellt wurden.Get a collection of bookingbusiness objects that has been created for the tenant.

Bei diesem Vorgang werden nur die ID und der DisplayName jedes Buchungs Geschäfts in der Auflistung zurückgegeben.This operation returns only the id and displayName of each Bookings business in the collection. Aus Leistungsgründen werden keine anderen Eigenschaften zurückgegeben.For performance considerations, it does not return other properties. Sie können die anderen Eigenschaften eines Buchungs Geschäfts abrufen, indem Sie dessen ID in einem Get -Vorgang angeben.You can get the other properties of a Bookings business by specifying its id in a GET operation.

Sie können auch Buchungen für Unternehmen Abfragen, indem Sie eine Zeichen query Folge in einem Parameter angeben, um eine Teilzeichenfolgenübereinstimmung zwischen den Unternehmen eines Mandanten durchführen.You can also query for Bookings businesses by specifying a string in a query parameter to do substring matching among the businesses of a tenant. Unten finden Sie ein Beispiel.See an example below.

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. Read. all, BookingsAppointment. ReadWrite. all, reservations. ReadWrite. all, reservations. Manage. allBookings.Read.All, BookingsAppointment.ReadWrite.All, Bookings.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

GET /bookingBusinesses

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData Query Parameters to help customize the response.

Diese Methode unterstützt auch query den-Parameter, der einen Zeichenfolgenwert akzeptiert.This method also supports the query parameter which accepts a string value. Dieser Parameter schränkt die Get-Ergebnisse auf Unternehmen ein, die mit der angegebenen Zeichenfolge übereinstimmen.This parameter limits the GET results to businesses that match the specified string. Sie können ein Beispiel unten sehen.You can see an example below.

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {code}Bearer {code}

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200 OK werden der Antwortcode und eine Sammlung von bookingBusiness -Objekten im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and collection of bookingBusiness objects in the response body.

BeispielExample

Anforderung 1Request 1

Im folgenden Beispiel werden die Buchungen Unternehmen in einem Mandanten abgerufen.The following example gets the Bookings businesses in a tenant.

GET https://graph.microsoft.com/beta/bookingBusinesses
Antwort 1Response 1

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

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

{
    "@odata.context":"https://graph.microsoft.com/beta/$metadata#bookingBusinesses",
    "value":[
        {
            "id":"Contosolunchdelivery@M365B489948.onmicrosoft.com",
            "displayName":"Contoso lunch delivery",
        },
        {
            "id":"Fabrikam@M365B489948.onmicrosoft.com",
            "displayName":"Fabrikam",
        }
    ]
}
Anforderung 2Request 2

Im folgenden Beispiel wird gezeigt, wie Sie query mit dem Parameter ein oder mehrere übereinstimmende Buchungen Unternehmen im Mandanten erhalten.The following example shows how to use the query parameter to get one or more matching Bookings businesses in the tenant.

GET https://graph.microsoft.com/beta/bookingBusinesses?query=Adventure
Antwort 2Response 2

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

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

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