Compartir a través de


Crear una página en la lista de páginas de sitio de un sitio

Espacio de nombres: microsoft.graph

Cree una nueva sitePage en la lista de páginas de sitio de un sitio.

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

POST /sites/{site-id}/pages

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 del recurso sitePage que se va a crear.

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 crear 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 crear 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 y 201 el objeto sitePage creado.

Ejemplo

En el ejemplo siguiente se muestra cómo crear una nueva página.

Solicitud

POST /sites/{site-id}/pages
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.sitePage",
  "name": "test.aspx",
  "title": "test",
  "pageLayout": "article",
  "showComments": true,
  "showRecommendedPages": false,
  "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",
    "imageSourceType": 2,
    "title": "sample1"
  },
  "canvasLayout": {
    "horizontalSections": [
      {
        "layout": "oneThirdRightColumn",
        "id": "1",
        "emphasis": "none",
        "columns": [
          {
            "id": "1",
            "width": 8,
            "webparts": [
              {
                "id": "6f9230af-2a98-4952-b205-9ede4f9ef548",
                "innerHtml": "<p><b>Hello!</b></p>"
              }
            ]
          },
          {
            "id": "2",
            "width": 4,
            "webparts": [
              {
                "id": "73d07dde-3474-4545-badb-f28ba239e0e1",
                "webPartType": "d1d91016-032f-456d-98a4-721247c305e8",
                "data": {
                  "dataVersion": "1.9",
                  "description": "Show an image on your page",
                  "title": "Image",
                  "properties": {
                    "imageSourceType": 2,
                    "altText": "",
                    "overlayText": "",
                    "siteid": "0264cabe-6b92-450a-b162-b0c3d54fe5e8",
                    "webid": "f3989670-cd37-4514-8ccb-0f7c2cbe5314",
                    "listid": "bdb41041-eb06-474e-ac29-87093386bb14",
                    "uniqueid": "d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb",
                    "imgWidth": 4288,
                    "imgHeight": 2848,
                    "fixAspectRatio": false,
                    "captionText": "",
                    "alignment": "Center"
                  },
                  "serverProcessedContent": {
                    "imageSources": [
                      {
                        "key": "imageSource",
                        "value": "/_LAYOUTS/IMAGES/VISUALTEMPLATEIMAGE1.JPG"
                      }
                    ],
                    "customMetadata": [
                      {
                        "key": "imageSource",
                        "value": {
                          "siteid": "0264cabe-6b92-450a-b162-b0c3d54fe5e8",
                          "webid": "f3989670-cd37-4514-8ccb-0f7c2cbe5314",
                          "listid": "bdb41041-eb06-474e-ac29-87093386bb14",
                          "uniqueid": "d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb",
                          "width": "4288",
                          "height": "2848"
                        }
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Respuesta

Si se ejecuta correctamente, este método devuelve un sitePage en el cuerpo de la respuesta de la página creada.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "microsoft.graph.sitePage",
    "id": "0dd6ddd6-45bd-4acd-b683-de0e6e7231b7",
    "name": "test.aspx",
    "webUrl": "https://contoso.sharepoint.com/SitePages/test.aspx",
    "title": "test",
    "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": "checkout",
      "versionId": "0.1",
      "checkedOutBy": {
        "user": {
          "displayName": "Rahul Mittal",
          "email": "rahmit@contoso.com"
        }
      }
    },
    "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": "sample4",
        "imageSourceType": 2
    }
}

Nota: El objeto Response se trunca para obtener una mayor claridad. Se devolverán las propiedades predeterminadas de la llamada actual.