Share via

Creación de webPart

  • Artículo

Espacio de nombres: microsoft.graph

Cree un nuevo elemento webPart en una posición especificada en sitePage.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Sites.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Sites.ReadWrite.All No disponible.

Solicitud 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 opcionales

Nombre Descripción
index Posición en la que se debe insertar el elemento web en la colección de elementos web

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de textWebPart o standardWebPart.

Para garantizar un análisis correcto del cuerpo de la solicitud, @odata.type=#microsoft.graph.textwebpart@odata.type=#microsoft.graph.standardwebpart o debe incluirse en el cuerpo de la solicitud.

Elementos web admitidos

Hay dos tipos de elementos web que se pueden agregar a un sitePage: standardWebPart y textWebPart.

Para standardWebPart, solo se admiten los siguientes elementos al actualizar mediante microsoft Graph API. Si se intenta agregar elementos web no admitidos, se producirá un error o una excepción.

# Elemento web Tipo
1 Mapas de Bing e377ea37-9047-43b9-8cdb-a761be2f8e09
2 Botón 0f087d7f-520e-42b7-89c0-496aaf979d58
3 Llamada a la acción df8e44e7-edd5-46d5-90da-aca1539313b8
4 Divisor 2161a1c6-db61-4731-b97c-3cdb303f7cbb
5 Inserción de documentos b7dd04e1-19ce-4b24-9132-b60a1c2b910d
6 Imagen d1d91016-032f-456d-98a4-721247c305e8
7 Galería de imágenes af8be689-990e-492a-81f7-ba3e4cd3ed9c
8 Vista previa de vínculos 6410b3b6-d440-4663-8744-378976dc041e
9 Org Chart e84a8ca2-f63c-4fb9-bc0b-d8eef5ccb22b
10 Contactos 7f718435-ee4d-431c-bdbf-9c4ff326f46e
11 Vínculos rápidos c70391ea-0b10-4ee9-b2b4-006d3fcad0cd
12 Espaciador 8654b779-4886-46d4-8ffb-b5ed960ee986
13 Inserción de Youtube 544dd15b-cf3c-441b-96da-004d5a8cea1d

Respuesta

Si se ejecuta correctamente, este método devuelve y 201 el objeto webPart creado en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra cómo crear un nuevo elemento 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."
}

Respuesta

Si se ejecuta correctamente, este método devuelve un elemento webPart en el cuerpo de la respuesta para el elemento webPart creado.

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