Compartir a través de

Actualizar sitePage

  • Artículo

Espacio de nombres: microsoft.graph

Actualice las propiedades de un objeto sitePage .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

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

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, únicamente proporcione los valores de las propiedades que deben actualizarse. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Estos campos y se usarán en las solicitudes de actualización.

Propiedad Tipo Descripción
description Cadena Descripción de la página del sitio. Opcional.
thumbnailWebUrl Cadena Dirección URL de la imagen en miniatura de la página de sitio. Opcional.
title Cadena Título de la página del sitio. Opcional.
showComments Booleano Boolean para determinar si se van a mostrar o no comentarios en la parte inferior de la página. Opcional.
showRecommendedPages Booleano Boolean para determinar si se muestran o no las páginas recomendadas en la parte inferior de la página. Opcional.
promotionKind PagePromotionType Tipo de promoción de la página de SharePoint. Opcional. Solo se admite la promoción de una página (por ejemplo, de page a newsPost). No se admite la disminución de nivel.
titleArea titleArea Área de título en la página del sitio. Opcional.
canvasLayout canvasLayout Diseño del contenido de una página, incluidas las secciones horizontales y verticales. Debe proporcionarse un contenido de todo el diseño de página; la función de actualización no admite actualizaciones parciales. Opcional.

Notas: :

  1. Para garantizar un análisis correcto del cuerpo de la solicitud, @odata.type=#microsoft.graph.sitePage debe incluirse en el cuerpo de la solicitud.
  2. Si usa la respuesta de la operación Get sitepage para actualizar un sitePage, se recomienda agregar el encabezado Accept: application/json;odata.metadata=noneHTTP . Esto quitará todos los metadatos de OData de la respuesta. También puede quitar manualmente todos los metadatos de OData.
  3. Solo se admite el elemento web que aparece en la sección Elementos web admitidos al actualizar un sitePage mediante Microsoft Graph API. Si se intenta agregar elementos web no admitidos, se producirá un error o una excepción.

Elementos web admitidos

Hay dos tipos de elementos web que se pueden agregar a un sitePage: standardWebParts y textWebPart. En la tabla siguiente se enumeran los elementos web admitidos para los elementos web estándar.

# 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 sitePage actualizado en el cuerpo de la respuesta.

Ejemplos

Solicitud

A continuación se muestra un ejemplo de una solicitud.

PATCH https://graph.microsoft.com/v1.0/sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.sitePage",
  "title": "sample",
  "showComments": true,
  "showRecommendedPages": false
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.sitePage",
  "id": "0dd6ddd6-45bd-4acd-b683-de0e6e7231b7",
  "name": "sample.aspx",
  "webUrl": "https://contoso.sharepoint.com/SitePages/sample.aspx",
  "title": "sample",
  "pageLayout": "article",
  "showComments": true,
  "showRecommendedPages": false,
  "createdBy": {
    "user": {
      "displayName": "Rahul Mittal",
      "email": "rahmit@contoso.com"
    }
  },
  "lastModifiedBy": {
    "user": {
      "displayName": "Rahul Mittal",
      "email": "rahmit@contoso.com"
    }
  },
  "publishingState": {
    "level": "draft",
    "versionId": "0.1"
  },
  "titleArea": {
    "enableGradientEffect": true,
    "imageWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg",
    "layout": "colorBlock",
    "showAuthor": true,
    "showPublishedDate": false,
    "showTextBlockAboveTitle": false,
    "textAboveTitle": "TEXT ABOVE TITLE",
    "textAlignment": "left",
    "title": "sample",
    "imageSourceType": 2
  }
}