Feedback Bearbeiten

Ort aktualisieren

  • Artikel
  • 10 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 .

Aktualisieren Sie die Eigenschaften des Place-Objekts , bei dem es sich um einen Raum oder eine RoomList handeln kann. Sie können den Raum oder die roomList identifizieren, indem Sie die ID oder emailAddress-Eigenschaft 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) Place.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung Nicht unterstützt

HTTP-Anforderung

PATCH /places/{id | emailAddress}

Anforderungsheader

Name Wert
Authorization Bearer {token}. Erforderlich.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Es kann jeweils nur eine Instanz einer Ortsressource (Raum oder RoomList) aktualisiert werden. Geben Sie @odata.type im Anforderungstext den Ortstyp an, und fügen Sie die Eigenschaften dieses Typs ein, der aktualisiert werden soll. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.

Eigenschaft Typ Beschreibung
address physicalAddress Die Adresse des Raums oder der Zimmerliste.
audioDeviceName Zeichenfolge Gibt den Namen des Audiogeräts im Raum an.
bookingType bookingType Raumtyp. Mögliche Werte sind Standard und Reserved.
Gebäude Zeichenfolge Gibt den Gebäudenamen oder die Gebäudenummer an, in dem sich der Raum befindet.
Kapazität Int32 Gibt die Kapazität des Raums an.
displayDeviceName Zeichenfolge Gibt den Namen des Anzeigegeräts im Raum an.
floorLabel Zeichenfolge Gibt den Bodenbuchstaben an, auf dem sich der Raum befindet.
floorNumber Int32 Gibt die Bodennummer an, auf der sich der Raum befindet.
geoCoordinates outlookGeoCoordinates Gibt die Position des Raums oder der Raumliste in Breiten-, Längen- und optional Höhenkoordinaten an.
isWheelChairAccessible Boolesch Gibt an, ob der Raum barrierefrei ist.
label Zeichenfolge Gibt eine beschreibende Beschriftung für den Raum an, z. B. eine Zahl oder einen Namen.
Spitzname Zeichenfolge Gibt einen Spitznamen für den Raum an, z. B. "Konferenzraum".
phone String Die Telefonnummer des Raums oder der Raumliste.
tags Zeichenfolgenauflistung Gibt zusätzliche Funktionen des Raums an, z. B. Details wie den Ansichts- oder Möbeltyp.
videoDeviceName Zeichenfolge Gibt den Namen des Videogeräts im Raum an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein aktualisiertes Place-Objekt im Antworttext zurückgegeben.

Beispiele

Beispiel 1: Aktualisieren eines Raums

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/places/cf100@contoso.com
Content-type: application/json

{
  "@odata.type": "microsoft.graph.room",
  "nickname": "Conf Room",
  "building": "1",
  "label": "100",
  "capacity": 50,
  "isWheelChairAccessible": false
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis

Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#places/$entity",
    "@odata.type": "#microsoft.graph.room",
    "id": "3162F1E1-C4C0-604B-51D8-91DA78989EB1",
    "emailAddress": "cf100@contoso.com",
    "displayName": "Conf Room 100",
    "address": {
      "street": "4567 Main Street",
      "city": "Buffalo",
      "state": "NY",
      "postalCode": "98052",
      "countryOrRegion": "USA"
    },
    "geoCoordinates": {
      "latitude": 47.0,
      "longitude": -122.0
    },
    "phone": "555-555-0100",
    "nickname": "Conf Room",
    "label": "100",
    "capacity": 50,
    "building": "1",
    "floorLabel": "1P",
    "floorNumber": 1,
    "isManaged": true,
    "isWheelChairAccessible": false,
    "bookingType": "standard",
    "tags": [
      "bean bags"
    ],
    "audioDeviceName": null,
    "videoDeviceName": null,
    "displayDevice": "surface hub"
}

Beispiel 2: Aktualisieren einer Raumliste

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/places/Building1RroomList@contoso.onmicrosoft.com
Content-type: application/json

{
  "@odata.type": "microsoft.graph.roomList",
  "displayName": "Building 1",
  "phone":"555-555-0100",
  "address": {
    "street": "4567 Main Street",
    "city": "Buffalo",
    "state": "NY",
    "postalCode": "98052",
    "countryOrRegion": "USA"
  },
  "geoCoordinates": {
    "altitude": null,
    "latitude": 47.0,
    "longitude": -122.0,
    "accuracy": null,
    "altitudeAccuracy": null
 }
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis

Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#places/$entity",
  "@odata.type": "#microsoft.graph.roomList",
  "id": "DC404124-302A-92AA-F98D-7B4DEB0C1705",
  "displayName": "Building 1",
  "address": {
    "street": "4567 Main Street",
    "city": "Buffalo",
    "state": "NY",
    "postalCode": "98052",
    "countryOrRegion": "USA"
  },
  "geoCoordinates": {
    "altitude": null,
    "latitude": 47.0,
    "longitude": -122.0,
    "accuracy": null,
    "altitudeAccuracy": null
 },
  "phone": "555-555-0100",
  "emailAddress": "bldg1@contoso.com"
}