Criar Peça Web
Namespace: microsoft.graph
Crie uma nova Peça Web numa posição especificada na Página do site.
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
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
Parâmetros de consulta opcionais
| Nome | Descrição |
|---|---|
| index | A posição na qual a peça Web deve ser inserida na coleção de peças Web |
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 201 objeto webPart criado e no corpo da resposta.
Exemplo
Solicitação
O exemplo seguinte mostra como criar uma nova peça Web.
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."
}
Resposta
Se for bem-sucedido, este método devolve uma Peça Web no corpo da resposta da Peça Web criada.
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."
}