Creación de webPart
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 |
14 | Área de título | cbe7b0a9-3504-44dd-a3a3-0e5cacd07788 |
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."
}