Поделиться через


Создание страницы в списке страниц сайта

Пространство имен: microsoft.graph

Создайте сайтPage в списке страниц сайта на сайте.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Sites.ReadWrite.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Sites.ReadWrite.All Недоступно.

HTTP-запрос

POST /sites/{site-id}/pages

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление создаваемого ресурса sitePage в формате JSON.

Примечания: :

  1. Чтобы обеспечить успешное синтаксический анализ текста запроса, @odata.type=#microsoft.graph.sitePage необходимо включить в текст запроса.
  2. Если вы используете ответ от операции Get sitepage для создания sitePage, рекомендуется добавить заголовок Accept: application/json;odata.metadata=noneHTTP . При этом все метаданные OData будут удалены из ответа. Вы также можете вручную удалить все метаданные OData.
  3. При создании sitePage с помощью API Microsoft Graph поддерживаются только веб-части, перечисленные в разделе Поддерживаемые веб-части. Попытка добавить неподдерживаемые веб-части приведет к сбою или исключению.

Поддерживаемые веб-части

Существует два типа веб-частей, которые можно добавить в sitePage: standardWebParts и textWebPart. В следующей таблице перечислены поддерживаемые веб-части для стандартных веб-частей.

# Веб-часть Тип
1 Карты Bing e377ea37-9047-43b9-8cdb-a761be2f8e09
2 Кнопка 0f087d7f-520e-42b7-89c0-496aaf979d58
3 Призыв к действию df8e44e7-edd5-46d5-90da-aca1539313b8
4 Делитель 2161a1c6-db61-4731-b97c-3cdb303f7cbb
5 Внедрение документа b7dd04e1-19ce-4b24-9132-b60a1c2b910d
6 Image d1d91016-032f-456d-98a4-721247c305e8
7 Коллекция изображений af8be689-990e-492a-81f7-ba3e4cd3ed9c
8 Предварительный просмотр ссылок 6410b3b6-d440-4663-8744-378976dc041e
9 Организационная диаграмма e84a8ca2-f63c-4fb9-bc0b-d8eef5ccb22b
10 Люди 7f718435-ee4d-431c-bdbf-9c4ff326f46e
11 Быстрые ссылки c70391ea-0b10-4ee9-b2b4-006d3fcad0cd
12 Проставка 8654b779-4886-46d4-8ffb-b5ed960ee986
13 Внедрение Youtube 544dd15b-cf3c-441b-96da-004d5a8cea1d
14 Область заголовка cbe7b0a9-3504-44dd-a3a3-0e5cacd07788

Отклик

В случае успешного выполнения этот метод возвращает 201 и созданный объект sitePage .

Пример

В следующем примере показано, как создать новую страницу.

Запрос

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

Отклик

В случае успешного выполнения этот метод возвращает sitePage в тексте ответа для созданной страницы.

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

Примечание. Ответ усечен для наглядности. При фактическом вызове будут возвращены свойства, используемые по умолчанию.