Actualizar webPart
Espacio de nombres: microsoft.graph
Actualice las propiedades de un objeto webPart .
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
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}
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 un 200 OK
código de respuesta y un objeto webPart actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra cómo actualizar un elemento 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."
}
Respuesta
Si se ejecuta correctamente, este método devuelve un elemento webPart en el cuerpo de la respuesta para el elemento web actualizado.
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."
}