Freigeben über

WebPart aktualisieren

  • Artikel

Namespace: microsoft.graph

Aktualisieren sie die Eigenschaften eines webPart-Objekts .

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Sites.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Sites.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/webParts/{webpart-id}
PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/verticalSection/webparts/{webpart-index}
PATCH /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/horizontalSections/{horizontal-section-id}/columns/{horizontal-section-column-id}/webparts/{webpart-index}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung von textWebPart oder standardWebPart an.

Um eine erfolgreiche Analyse des Anforderungstexts sicherzustellen, muss oder @odata.type=#microsoft.graph.textwebpart@odata.type=#microsoft.graph.standardwebpart im Anforderungstext enthalten sein.

Unterstützte Webparts

Es gibt zwei Arten von Webparts, die einer sitePage hinzugefügt werden können: standardWebPart und textWebPart.

Für standardWebPart werden beim Aktualisieren mithilfe der Microsoft Graph-API nur die folgenden Unterstützt. Der Versuch, nicht unterstützte Webparts hinzuzufügen, führt zu einem Fehler oder einer Ausnahme.

# Webpart Typ
1 Bing Maps e377ea37-9047-43b9-8cdb-a761be2f8e09
2 Schaltfläche 0f087d7f-520e-42b7-89c0-496aaf979d58
3 Handlungsaufruf df8e44e7-edd5-46d5-90da-aca1539313b8
4 Teiler 2161a1c6-db61-4731-b97c-3cdb303f7cbb
5 Einbetten von Dokumenten b7dd04e1-19ce-4b24-9132-b60a1c2b910d
6 Bild d1d91016-032f-456d-98a4-721247c305e8
7 Bildergalerie af8be689-990e-492a-81f7-ba3e4cd3ed9c
8 Linkvorschau 6410b3b6-d440-4663-8744-378976dc041e
9 Organigramm e84a8ca2-f63c-4fb9-bc0b-d8eef5ccb22b
10 Personen 7f718435-ee4d-431c-bdbf-9c4ff326f46e
11 Quicklinks c70391ea-0b10-4ee9-b2b4-006d3fcad0cd
12 Abstandhalter 8654b779-4886-46d4-8ffb-b5ed960ee986
13 Youtube Embed 544dd15b-cf3c-441b-96da-004d5a8cea1d
14 Titelbereich cbe7b0a9-3504-44dd-a3a3-0e5cacd07788

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes WebPart-Objekt im Antworttext zurück.

Beispiel

Anforderung

Das folgende Beispiel zeigt, wie ein Webpart aktualisiert wird.

PATCH /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage/webParts/c867fd9e-4c1e-43ec-a448-9760c9fff589
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.textWebPart",
  "innerHtml": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus blandit pellentesque ipsum tempor porta. Phasellus tincidunt et ipsum nec iaculis. Sed eu arcu tristique, congue erat a, consequat lorem. Suspendisse ac ullamcorper elit. Sed ultricies, risus sed hendrerit dictum, nunc massa ornare velit, a pharetra dolor urna quis lorem. Maecenas eget pellentesque purus, nec ultricies risus. Donec rhoncus lorem at euismod varius. Donec auctor sed mi vitae pharetra. Aenean id tempor mauris. Donec dui nulla, semper ut elit id, mattis commodo arcu. Aliquam erat volutpat."
}

Antwort

Bei erfolgreicher Ausführung gibt die Methode ein webPart im Antworttext für das aktualisierte Webpart zurück.

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

{
  "@odata.type": "#microsoft.graph.textWebPart",
  "id": "51053496-e6f3-4161-94ac-07bdf4d92226",
  "innerHtml": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus blandit pellentesque ipsum tempor porta. Phasellus tincidunt et ipsum nec iaculis. Sed eu arcu tristique, congue erat a, consequat lorem. Suspendisse ac ullamcorper elit. Sed ultricies, risus sed hendrerit dictum, nunc massa ornare velit, a pharetra dolor urna quis lorem. Maecenas eget pellentesque purus, nec ultricies risus. Donec rhoncus lorem at euismod varius. Donec auctor sed mi vitae pharetra. Aenean id tempor mauris. Donec dui nulla, semper ut elit id, mattis commodo arcu. Aliquam erat volutpat."
}