WebPart aktualisieren

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 mit dem 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	Spacer	8654b779-4886-46d4-8ffb-b5ed960ee986
13	Youtube Embed	544dd15b-cf3c-441b-96da-004d5a8cea1d

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."
}