Обновление веб-части

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

Обновление свойств объекта webPart .

Разрешения

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

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

HTTP-запрос

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}

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

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

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

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

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

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

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

Для standardWebPart при обновлении с помощью API Microsoft 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
14	Область заголовка	cbe7b0a9-3504-44dd-a3a3-0e5cacd07788

Отклик

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

Пример

Запрос

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

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

Отклик

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

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