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

Создание веб-части

  • Статья

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

Создайте веб-часть в указанной позиции в sitePage.

Разрешения

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

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

HTTP-запрос

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

Необязательные параметры запросов

Имя Описание
index Позиция, в которой веб-часть должна быть вставлена в коллекцию веб-частей

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

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

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

В тексте запроса укажите json-представление textWebPart или standardWebPart.

Чтобы обеспечить успешное синтаксический анализ текста запроса, @odata.type=#microsoft.graph.textwebpart объект или @odata.type=#microsoft.graph.standardwebpart должен быть включен в текст запроса.

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

Существует два типа веб-частей, которые можно добавить в sitePage: standardWebPart и textWebPart.

Для standardWebPart при обновлении с помощью API Graph Майкрософт поддерживаются только следующие компоненты. Попытка добавить неподдерживаемые веб-части приведет к сбою или исключению.

# Веб-часть Тип
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

Отклик

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

Пример

Запрос

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

POST /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202//microsoft.graph.sitePage/canvasLayout/verticalSection/webparts
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."
}

Отклик

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

HTTP/1.1 201 Created
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."
}