Freigeben über

SitePage aktualisieren

  • Artikel

Namespace: microsoft.graph

Aktualisieren sie die Eigenschaften eines sitePage-Objekts .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

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

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 nur die Werte für zu aktualisierende Eigenschaften an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Diese Felder und werden in Updateanforderungen verwendet.

Eigenschaft Typ Beschreibung
description String Beschreibung der Websiteseite. Optional.
thumbnailWebUrl String URL des Miniaturbilds der Websiteseite. Optional.
title String Titel der Websiteseite. Optional.
ShowComments Boolesch Boolescher Wert, um zu bestimmen, ob Kommentare am unteren Rand der Seite angezeigt werden sollen. Optional.
showRecommendedPages Boolesch Boolescher Wert, um zu bestimmen, ob empfohlene Seiten unten auf der Seite angezeigt werden sollen. Optional.
promotionKind PagePromotionType Heraufstufungsart der SharePoint-Seite. Optional. Unterstützen Sie nur das Heraufstufen einer Seite (z. B. von page zu newsPost). Das Herabstufen wird nicht unterstützt.
titleArea titleArea Titelbereich auf der Websiteseite. Optional.
canvasLayout canvasLayout Das Layout des Inhalts auf einer Seite, einschließlich horizontaler Abschnitte und vertikaler Abschnitte. Ein Inhalt des gesamten Seitenlayouts muss bereitgestellt werden, die Updatefunktion unterstützt keine Teilupdates. Optional.

Hinweise: :

  1. Um eine erfolgreiche Analyse des Anforderungstexts sicherzustellen, muss der @odata.type=#microsoft.graph.sitePage in den Anforderungstext aufgenommen werden.
  2. Wenn Sie die Antwort des Vorgangs Get sitepage verwenden, um eine sitePage zu aktualisieren, wird empfohlen, den HTTP-Header Accept: application/json;odata.metadata=nonehinzuzufügen. Dadurch werden alle OData-Metadaten aus der Antwort entfernt. Sie können auch alle OData-Metadaten manuell entfernen.
  3. Nur das im Abschnitt Unterstützte Webparts aufgeführte Webpart wird unterstützt, wenn eine sitePage mithilfe des Microsoft Graph-API aktualisiert wird. Der Versuch, nicht unterstützte Webparts hinzuzufügen, führt zu einem Fehler oder einer Ausnahme.

Unterstützte Webparts

Es gibt zwei Arten von Webparts, die einer SitePage hinzugefügt werden können: standardWebParts und textWebPart. In der folgenden Tabelle sind die unterstützten Webparts für Standardwebparts aufgeführt.

# 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 einen 200 OK Antwortcode und ein aktualisiertes sitePage-Objekt im Antworttext zurück.

Beispiele

Anforderung

Nachfolgend ist ein Beispiel für eine Anforderung dargestellt.

PATCH https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.sitePage",
  "title": "sample",
  "showComments": true,
  "showRecommendedPages": false
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

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

{
  "@odata.type": "#microsoft.graph.sitePage",
  "id": "0dd6ddd6-45bd-4acd-b683-de0e6e7231b7",
  "name": "sample.aspx",
  "webUrl": "https://contoso.sharepoint.com/SitePages/sample.aspx",
  "title": "sample",
  "pageLayout": "article",
  "showComments": true,
  "showRecommendedPages": false,
  "createdBy": {
    "user": {
      "displayName": "Rahul Mittal",
      "email": "rahmit@contoso.com"
    }
  },
  "lastModifiedBy": {
    "user": {
      "displayName": "Rahul Mittal",
      "email": "rahmit@contoso.com"
    }
  },
  "publishingState": {
    "level": "draft",
    "versionId": "0.1"
  },
  "titleArea": {
    "enableGradientEffect": true,
    "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg",
    "layout": "colorBlock",
    "showAuthor": true,
    "showPublishedDate": false,
    "showTextBlockAboveTitle": false,
    "textAboveTitle": "TEXT ABOVE TITLE",
    "textAlignment": "left",
    "title": "sample",
    "imageSourceType": 2
  }
}