Freigeben über


Erstellen einer Seite in der Websiteseitenliste einer Website

Namespace: microsoft.graph

Erstellen Sie eine neue sitePage in der Websiteseitenliste einer Website.

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

POST /sites/{site-id}/pages

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 der zu erstellenden sitePage-Ressource an.

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 erstellen, 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 beim Erstellen einer sitePage mithilfe der Microsoft Graph-API unterstützt. 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 ein 201 - und das erstellte sitePage-Objekt zurück.

Beispiel

Das folgende Beispiel zeigt, wie Sie eine neue Seite erstellen.

Anforderung

POST /sites/{site-id}/pages
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.sitePage",
  "name": "test.aspx",
  "title": "test",
  "pageLayout": "article",
  "showComments": true,
  "showRecommendedPages": false,
  "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",
    "imageSourceType": 2,
    "title": "sample1"
  },
  "canvasLayout": {
    "horizontalSections": [
      {
        "layout": "oneThirdRightColumn",
        "id": "1",
        "emphasis": "none",
        "columns": [
          {
            "id": "1",
            "width": 8,
            "webparts": [
              {
                "id": "6f9230af-2a98-4952-b205-9ede4f9ef548",
                "innerHtml": "<p><b>Hello!</b></p>"
              }
            ]
          },
          {
            "id": "2",
            "width": 4,
            "webparts": [
              {
                "id": "73d07dde-3474-4545-badb-f28ba239e0e1",
                "webPartType": "d1d91016-032f-456d-98a4-721247c305e8",
                "data": {
                  "dataVersion": "1.9",
                  "description": "Show an image on your page",
                  "title": "Image",
                  "properties": {
                    "imageSourceType": 2,
                    "altText": "",
                    "overlayText": "",
                    "siteid": "0264cabe-6b92-450a-b162-b0c3d54fe5e8",
                    "webid": "f3989670-cd37-4514-8ccb-0f7c2cbe5314",
                    "listid": "bdb41041-eb06-474e-ac29-87093386bb14",
                    "uniqueid": "d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb",
                    "imgWidth": 4288,
                    "imgHeight": 2848,
                    "fixAspectRatio": false,
                    "captionText": "",
                    "alignment": "Center"
                  },
                  "serverProcessedContent": {
                    "imageSources": [
                      {
                        "key": "imageSource",
                        "value": "/_LAYOUTS/IMAGES/VISUALTEMPLATEIMAGE1.JPG"
                      }
                    ],
                    "customMetadata": [
                      {
                        "key": "imageSource",
                        "value": {
                          "siteid": "0264cabe-6b92-450a-b162-b0c3d54fe5e8",
                          "webid": "f3989670-cd37-4514-8ccb-0f7c2cbe5314",
                          "listid": "bdb41041-eb06-474e-ac29-87093386bb14",
                          "uniqueid": "d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb",
                          "width": "4288",
                          "height": "2848"
                        }
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine sitePage im Antworttext für die erstellte Seite zurück.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "microsoft.graph.sitePage",
    "id": "0dd6ddd6-45bd-4acd-b683-de0e6e7231b7",
    "name": "test.aspx",
    "webUrl": "https://contoso.sharepoint.com/SitePages/test.aspx",
    "title": "test",
    "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": "checkout",
      "versionId": "0.1",
      "checkedOutBy": {
        "user": {
          "displayName": "Rahul Mittal",
          "email": "rahmit@contoso.com"
        }
      }
    },
    "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": "sample4",
        "imageSourceType": 2
    }
}

Hinweis: Das „Response“-Objekt wurde zwecks besserer Übersichtlichkeit gekürzt. Der tatsächliche Aufruf gibt die Standardeigenschaften zurück.