Compartilhar via

Atualizar Peça Web

  • Artigo

Namespace: microsoft.graph

Atualize as propriedades de um objeto webPart .

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Sites.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sites.ReadWrite.All Indisponível.

Solicitação 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}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON do textoWebPart ou standardWebPart.

Para garantir uma análise bem-sucedida do corpo do pedido, o @odata.type=#microsoft.graph.textwebpart ou @odata.type=#microsoft.graph.standardwebpart tem de ser incluído no corpo do pedido.

Peças Web suportadas

Existem dois tipos de peças Web que podem ser adicionadas a um sitePage: standardWebPart e textWebPart.

Para standardWebPart, apenas os seguintes são suportados ao atualizar com a Microsoft Graph API. Tentar adicionar peças Web não suportadas resultará numa falha ou exceção.

# Web Part Tipo
1 Bing Mapas e377ea37-9047-43b9-8cdb-a761be2f8e09
2 Botão 0f087d7f-520e-42b7-89c0-496aaf979d58
3 Chamada à Ação df8e44e7-edd5-46d5-90da-aca1539313b8
4 Separador 2161a1c6-db61-4731-b97c-3cdb303f7cbb
5 Incorporar Documento b7dd04e1-19ce-4b24-9132-b60a1c2b910d
6 Image d1d91016-032f-456d-98a4-721247c305e8
7 Galeria de Imagens af8be689-990e-492a-81f7-ba3e4cd3ed9c
8 Pré-visualização da Ligação 6410b3b6-d440-4663-8744-378976dc041e
9 Organograma e84a8ca2-f63c-4fb9-bc0b-d8eef5ccb22b
10 Pessoas 7f718435-ee4d-431c-bdbf-9c4ff326f46e
11 Ligações rápidas c70391ea-0b10-4ee9-b2b4-006d3fcad0cd
12 Espaçador 8654b779-4886-46d4-8ffb-b5ed960ee986
13 Incorporação do Youtube 544dd15b-cf3c-441b-96da-004d5a8cea1d
14 Área do Título cbe7b0a9-3504-44dd-a3a3-0e5cacd07788

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto webPart atualizado no corpo da resposta.

Exemplo

Solicitação

O exemplo seguinte mostra como atualizar uma peça Web.

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

Resposta

Se for bem-sucedido, este método devolve uma Peça Web no corpo da resposta da peça Web atualizada.

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