Feedback Bearbeiten

user: findRooms

  • Artikel
  • 6 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Abrufen aller emailAddress-Objekte, die alle Besprechungsräume im Mandanten des Benutzers oder in einer bestimmten Raumliste darstellen.

Mandanten können Besprechungsräume in Raumlisten organisieren. In dieser API wird jeder Besprechungsraum und jede Raumliste durch eine emailAddress-Instanz dargestellt. Sie können alle Raumlisten im Mandanten, alle Räume im Mandanten oder alle Räume in einer bestimmten Raumliste abrufen. Sie können die ersten 100 Räume im Mandanten abrufen.

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) User.ReadBasic.All, User.Read.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application User.Read.All

HTTP-Anforderung

So rufen Sie alle Räume im Mandanten ab:

GET /me/findRooms
GET /users/{id}/findRooms

So rufen Sie alle Räume in einer bestimmten Raumliste des Mandanten ab:

GET /me/findRooms(RoomList='{room_list_emailAddress}')
GET /users/{id}/findRooms(RoomList='{room_list_emailAddress}')

Abfrageparameter

Abfrageparameter Typ Beschreibung
RoomList string Die der Raumliste zugeordnete SMTP-Adresse. Jede Raumliste wird durch eine emailAddress-Instanz dargestellt, die eine SMTP-Adresse enthält.

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich.
Content-Type string application/json. Erforderlich.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

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

Beispiel

Anforderung 1

Das erste Beispiel ruft die emailAddress-Objekte ab, die alle Räume darstellen, die im Mandanten des angemeldeten Benutzers definiert sind.

GET https://graph.microsoft.com/beta/me/findRooms
Antwort 1

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.emailAddress)",
    "value": [
        {
            "name": "Conf Room Adams",
            "address": "Adams@contoso.onmicrosoft.com"
        },
        {
            "name": "Conf Room Baker",
            "address": "Baker@contoso.onmicrosoft.com"
        },
        {
            "name": "Conf Room Crystal",
            "address": "Crystal@contoso.onmicrosoft.com"
        },
        {
            "name": "Conf Room Hood",
            "address": "Hood@contoso.onmicrosoft.com"
        },
        {
            "name": "Conf Room Rainier",
            "address": "Rainier@contoso.onmicrosoft.com"
        },
        {
            "name": "Conf Room Stevens",
            "address": "Stevens@contoso.onmicrosoft.com"
        }
    ]
}
Anforderung 2

Das zweite Beispiel ruft die emailAddress-Objekte ab, die die Räume in der angegebenen Raumliste darstellen, die durch die E-Mail-Adresse Building2Rooms@contoso.onmicrosoft.com gekennzeichnet ist.

GET https://graph.microsoft.com/beta/me/findRooms(RoomList='Building2Rooms@contoso.onmicrosoft.com')
Antwort 2

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.emailAddress)",
    "value": [
        {
            "name": "Conf Room Baker",
            "address": "Baker@contoso.onmicrosoft.com"
        },
        {
            "name": "Conf Room Hood",
            "address": "Hood@contoso.onmicrosoft.com"
        },
        {
            "name": "Conf Room Rainier",
            "address": "Rainier@contoso.onmicrosoft.com"
        }
    ]
}