Actualizar newsLinkPage
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta
de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Actualice las propiedades de un objeto newsLinkPage .
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/{pageId}/microsoft.graph.newsLinkPage
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 para contenido JSON, incluida la propiedad title necesaria en solicitudes de varias partes. Las solicitudes de varias partes usan los datos de varias partes o formularios; boundary=su tipo de contenido de límite. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. 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.
Propiedad | Tipo | Descripción |
---|---|---|
description | Cadena | Texto descriptivo del elemento. El límite de longitud máxima es de 250 caracteres. Se hereda de baseSitePage. |
newsWebUrl | Cadena | Dirección URL del artículo de noticias al que hace referencia newsLinkPage. Puede ser un vínculo externo. |
title | Cadena | Título de newsLinkPage. El límite de longitud máximo es de 110 caracteres. Se hereda de baseSitePage. |
Notas: Para actualizar la propiedad bannerImage , cargue los bytes de imagen de la nueva imagen de banner que desea establecer. La imagen de banner se guarda automáticamente en la biblioteca de recursos del sitio y la dirección URL de la imagen de banner se genera en función del archivo persistente. Realice una solicitud de varias partes y establezca la
@microsoft.graph.bannerImageWebUrlContent
anotación para enviar el contenido de la imagen, como se muestra en el ejemplo.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto newsLinkPage actualizado en el cuerpo de la respuesta.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PATCH https://graph.microsoft.com/beta/sites/c1370818-f5e0-4a40-a99b-be4520640642/pages/637c601e-0d0e-43c0-b50f-b18513bb9de2/microsoft.graph.newsLinkPage
Content-type: multipart/form-data; boundary=MyPartBoundary198374
--MyPartBoundary198374
Content-Disposition:form-data; name="metadata"
Content-Type: application/json
{
"title": "External News | Microsoft Build brings AI tools to the forefront for developers",
"@microsoft.graph.bannerImageWebUrlContent" : "name:content"
}
--MyPartBoundary198374
Content-Disposition:form-data; name="content"
Content-Type: image/jpeg
... binary file data ...
--MyPartBoundary198374--
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.newsLinkPage",
"createdDateTime": "2024-06-11T17:31:20Z",
"description": " You only need two simple letters to accurately convey the major shift in the technology space this year: A and I. Beyond those letters, however, is a complex, evolving and exciting way in which we work, communicate and collaborate.",
"eTag": "\"{179210C2-637E-4C61-8491-331D0D4A0C05},2\"",
"id": "179210c2-637e-4c61-8491-331d0d4a0c05",
"lastModifiedDateTime": "2024-06-11T17:31:21Z",
"name": "microsoft-build-ai-tools-developers.aspx",
"webUrl": "https://contoso.sharepoint.com/SitePages/Microsoft-Build-brings-AI-tools-to-the-forefront-for-developers.aspx",
"title": "External News | Microsoft Build brings AI tools to the forefront for developers",
"pageLayout": "newsLink",
"bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/microsoft-build-ai-tools-developers/BannerImage.png",
"newsWebUrl": "https://someexternalnewssite.com/2024/05/23/microsoft-build-ai-tools-developers",
"createdBy": {
"user": {
"displayName": "John Doe",
"email": "jdoe@contoso.com"
}
},
"lastModifiedBy": {
"user": {
"displayName": "John Doe",
"email": "jdoe@contoso.com"
}
},
"publishingState": {
"level": "checkout",
"versionId": "0.1",
"checkedOutBy": {
"user": {
"displayName": "John Doe",
"email": "jdoe@contoso.com"
}
}
}
}