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

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.

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

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global	Administración pública de EE. UU.	Gobierno de EE. UU. L5 (DOD)	China operado por 21Vianet
✅	✅	✅	✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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 autenticación y 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: :

Para garantizar un análisis correcto del cuerpo de la solicitud, este @odata.type=#microsoft.graph.sitePage debe incluirse en el cuerpo de la solicitud.

Si usa la respuesta de la operación Obtener páginasitio para crear un elemento SitePage, le recomendamos que agregue el encabezado Accept: application/json;odata.metadata=noneHTTP. Esto quitará todos los metadatos OData de la respuesta. También puede quitar manualmente todos los metadatos de OData.

Respuesta

Si tiene éxito, este método devuelve un 201 objeto sitePage creado.

Ejemplo

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

Solicitud

POST https://graph.microsoft.com/beta/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/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"
                        }
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;
using Microsoft.Kiota.Abstractions.Serialization;

var requestBody = new SitePage
{
	OdataType = "#microsoft.graph.sitePage",
	Name = "test.aspx",
	Title = "test",
	PageLayout = PageLayoutType.Article,
	ShowComments = true,
	ShowRecommendedPages = false,
	TitleArea = new TitleArea
	{
		EnableGradientEffect = true,
		ImageWebUrl = "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg",
		Layout = TitleAreaLayoutType.ColorBlock,
		ShowAuthor = true,
		ShowPublishedDate = false,
		ShowTextBlockAboveTitle = false,
		TextAboveTitle = "TEXT ABOVE TITLE",
		TextAlignment = TitleAreaTextAlignmentType.Left,
		AdditionalData = new Dictionary<string, object>
		{
			{
				"imageSourceType" , 2
			},
			{
				"title" , "sample1"
			},
		},
	},
	CanvasLayout = new CanvasLayout
	{
		HorizontalSections = new List<HorizontalSection>
		{
			new HorizontalSection
			{
				Layout = HorizontalSectionLayoutType.OneThirdRightColumn,
				Id = "1",
				Emphasis = SectionEmphasisType.None,
				Columns = new List<HorizontalSectionColumn>
				{
					new HorizontalSectionColumn
					{
						Id = "1",
						Width = 8,
						Webparts = new List<WebPart>
						{
							new WebPart
							{
								Id = "6f9230af-2a98-4952-b205-9ede4f9ef548",
								AdditionalData = new Dictionary<string, object>
								{
									{
										"innerHtml" , "<p><b>Hello!</b></p>"
									},
								},
							},
						},
					},
					new HorizontalSectionColumn
					{
						Id = "2",
						Width = 4,
						Webparts = new List<WebPart>
						{
							new WebPart
							{
								Id = "73d07dde-3474-4545-badb-f28ba239e0e1",
								AdditionalData = new Dictionary<string, object>
								{
									{
										"webPartType" , "d1d91016-032f-456d-98a4-721247c305e8"
									},
									{
										"data" , new UntypedObject(new Dictionary<string, UntypedNode>
										{
											{
												"dataVersion", new UntypedString("1.9")
											},
											{
												"description", new UntypedString("Show an image on your page")
											},
											{
												"title", new UntypedString("Image")
											},
											{
												"properties", new UntypedObject(new Dictionary<string, UntypedNode>
												{
													{
														"imageSourceType", new UntypedString("2")
													},
													{
														"altText", new UntypedString("")
													},
													{
														"overlayText", new UntypedString("")
													},
													{
														"siteid", new UntypedString("0264cabe-6b92-450a-b162-b0c3d54fe5e8")
													},
													{
														"webid", new UntypedString("f3989670-cd37-4514-8ccb-0f7c2cbe5314")
													},
													{
														"listid", new UntypedString("bdb41041-eb06-474e-ac29-87093386bb14")
													},
													{
														"uniqueid", new UntypedString("d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb")
													},
													{
														"imgWidth", new UntypedString("4288")
													},
													{
														"imgHeight", new UntypedString("2848")
													},
													{
														"fixAspectRatio", new UntypedBoolean(false)
													},
													{
														"captionText", new UntypedString("")
													},
													{
														"alignment", new UntypedString("Center")
													},
												})
											},
											{
												"serverProcessedContent", new UntypedObject(new Dictionary<string, UntypedNode>
												{
													{
														"imageSources", new UntypedArray(new List<UntypedNode>
														{
															new UntypedObject(new Dictionary<string, UntypedNode>
															{
																{
																	"key", new UntypedString("imageSource")
																},
																{
																	"value", new UntypedString("/_LAYOUTS/IMAGES/VISUALTEMPLATEIMAGE1.JPG")
																},
															}),
														})
													},
													{
														"customMetadata", new UntypedArray(new List<UntypedNode>
														{
															new UntypedObject(new Dictionary<string, UntypedNode>
															{
																{
																	"key", new UntypedString("imageSource")
																},
																{
																	"value", new UntypedObject(new Dictionary<string, UntypedNode>
																	{
																		{
																			"siteid", new UntypedString("0264cabe-6b92-450a-b162-b0c3d54fe5e8")
																		},
																		{
																			"webid", new UntypedString("f3989670-cd37-4514-8ccb-0f7c2cbe5314")
																		},
																		{
																			"listid", new UntypedString("bdb41041-eb06-474e-ac29-87093386bb14")
																		},
																		{
																			"uniqueid", new UntypedString("d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb")
																		},
																		{
																			"width", new UntypedString("4288")
																		},
																		{
																			"height", new UntypedString("2848")
																		},
																	})
																},
															}),
														})
													},
												})
											},
										})
									},
								},
							},
						},
					},
				},
			},
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Sites["{site-id}"].Pages.PostAsync(requestBody);

Importante

Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

SitePage baseSitePage = new SitePage();
baseSitePage.setOdataType("#microsoft.graph.sitePage");
baseSitePage.setName("test.aspx");
baseSitePage.setTitle("test");
baseSitePage.setPageLayout(PageLayoutType.Article);
baseSitePage.setShowComments(true);
baseSitePage.setShowRecommendedPages(false);
TitleArea titleArea = new TitleArea();
titleArea.setEnableGradientEffect(true);
titleArea.setImageWebUrl("https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg");
titleArea.setLayout(TitleAreaLayoutType.ColorBlock);
titleArea.setShowAuthor(true);
titleArea.setShowPublishedDate(false);
titleArea.setShowTextBlockAboveTitle(false);
titleArea.setTextAboveTitle("TEXT ABOVE TITLE");
titleArea.setTextAlignment(TitleAreaTextAlignmentType.Left);
HashMap<String, Object> additionalData = new HashMap<String, Object>();
additionalData.put("imageSourceType", 2);
additionalData.put("title", "sample1");
titleArea.setAdditionalData(additionalData);
baseSitePage.setTitleArea(titleArea);
CanvasLayout canvasLayout = new CanvasLayout();
LinkedList<HorizontalSection> horizontalSections = new LinkedList<HorizontalSection>();
HorizontalSection horizontalSection = new HorizontalSection();
horizontalSection.setLayout(HorizontalSectionLayoutType.OneThirdRightColumn);
horizontalSection.setId("1");
horizontalSection.setEmphasis(SectionEmphasisType.None);
LinkedList<HorizontalSectionColumn> columns = new LinkedList<HorizontalSectionColumn>();
HorizontalSectionColumn horizontalSectionColumn = new HorizontalSectionColumn();
horizontalSectionColumn.setId("1");
horizontalSectionColumn.setWidth(8);
LinkedList<WebPart> webparts = new LinkedList<WebPart>();
WebPart webPart = new WebPart();
webPart.setId("6f9230af-2a98-4952-b205-9ede4f9ef548");
HashMap<String, Object> additionalData1 = new HashMap<String, Object>();
additionalData1.put("innerHtml", "<p><b>Hello!</b></p>");
webPart.setAdditionalData(additionalData1);
webparts.add(webPart);
horizontalSectionColumn.setWebparts(webparts);
columns.add(horizontalSectionColumn);
HorizontalSectionColumn horizontalSectionColumn1 = new HorizontalSectionColumn();
horizontalSectionColumn1.setId("2");
horizontalSectionColumn1.setWidth(4);
LinkedList<WebPart> webparts1 = new LinkedList<WebPart>();
WebPart webPart1 = new WebPart();
webPart1.setId("73d07dde-3474-4545-badb-f28ba239e0e1");
HashMap<String, Object> additionalData2 = new HashMap<String, Object>();
additionalData2.put("webPartType", "d1d91016-032f-456d-98a4-721247c305e8");
 data = new ();
data.setDataVersion("1.9");
data.setDescription("Show an image on your page");
data.setTitle("Image");
 properties = new ();
properties.setImageSourceType(2);
properties.setAltText("");
properties.setOverlayText("");
properties.setSiteid("0264cabe-6b92-450a-b162-b0c3d54fe5e8");
properties.setWebid("f3989670-cd37-4514-8ccb-0f7c2cbe5314");
properties.setListid("bdb41041-eb06-474e-ac29-87093386bb14");
properties.setUniqueid("d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb");
properties.setImgWidth(4288);
properties.setImgHeight(2848);
properties.setFixAspectRatio(false);
properties.setCaptionText("");
properties.setAlignment("Center");
data.setProperties(properties);
 serverProcessedContent = new ();
LinkedList<Object> imageSources = new LinkedList<Object>();
 property = new ();
property.setKey("imageSource");
property.setValue("/_LAYOUTS/IMAGES/VISUALTEMPLATEIMAGE1.JPG");
imageSources.add(property);
serverProcessedContent.setImageSources(imageSources);
LinkedList<Object> customMetadata = new LinkedList<Object>();
 property1 = new ();
property1.setKey("imageSource");
 value1 = new ();
value1.setSiteid("0264cabe-6b92-450a-b162-b0c3d54fe5e8");
value1.setWebid("f3989670-cd37-4514-8ccb-0f7c2cbe5314");
value1.setListid("bdb41041-eb06-474e-ac29-87093386bb14");
value1.setUniqueid("d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb");
value1.setWidth("4288");
value1.setHeight("2848");
property1.setValue(value1);
customMetadata.add(property1);
serverProcessedContent.setCustomMetadata(customMetadata);
data.setServerProcessedContent(serverProcessedContent);
additionalData2.put("data", data);
webPart1.setAdditionalData(additionalData2);
webparts1.add(webPart1);
horizontalSectionColumn1.setWebparts(webparts1);
columns.add(horizontalSectionColumn1);
horizontalSection.setColumns(columns);
horizontalSections.add(horizontalSection);
canvasLayout.setHorizontalSections(horizontalSections);
baseSitePage.setCanvasLayout(canvasLayout);
BaseSitePage result = graphClient.sites().bySiteId("{site-id}").pages().post(baseSitePage);

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const baseSitePage = {
  '@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'
                        }
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
};

await client.api('/sites/a69edae4-9208-4f60-9aa3-cd0911ff0ce1/pages')
	.version('beta')
	.post(baseSitePage);

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\SitePage;
use Microsoft\Graph\Beta\Generated\Models\PageLayoutType;
use Microsoft\Graph\Beta\Generated\Models\TitleArea;
use Microsoft\Graph\Beta\Generated\Models\TitleAreaLayoutType;
use Microsoft\Graph\Beta\Generated\Models\TitleAreaTextAlignmentType;
use Microsoft\Graph\Beta\Generated\Models\CanvasLayout;
use Microsoft\Graph\Beta\Generated\Models\HorizontalSection;
use Microsoft\Graph\Beta\Generated\Models\HorizontalSectionLayoutType;
use Microsoft\Graph\Beta\Generated\Models\SectionEmphasisType;
use Microsoft\Graph\Beta\Generated\Models\HorizontalSectionColumn;
use Microsoft\Graph\Beta\Generated\Models\WebPart;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new SitePage();
$requestBody->setOdataType('#microsoft.graph.sitePage');
$requestBody->setName('test.aspx');
$requestBody->setTitle('test');
$requestBody->setPageLayout(new PageLayoutType('article'));
$requestBody->setShowComments(true);
$requestBody->setShowRecommendedPages(false);
$titleArea = new TitleArea();
$titleArea->setEnableGradientEffect(true);
$titleArea->setImageWebUrl('https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg');
$titleArea->setLayout(new TitleAreaLayoutType('colorBlock'));
$titleArea->setShowAuthor(true);
$titleArea->setShowPublishedDate(false);
$titleArea->setShowTextBlockAboveTitle(false);
$titleArea->setTextAboveTitle('TEXT ABOVE TITLE');
$titleArea->setTextAlignment(new TitleAreaTextAlignmentType('left'));
$additionalData = [
	'imageSourceType' => 2,
	'title' => 'sample1',
];
$titleArea->setAdditionalData($additionalData);
$requestBody->setTitleArea($titleArea);
$canvasLayout = new CanvasLayout();
$horizontalSectionsHorizontalSection1 = new HorizontalSection();
$horizontalSectionsHorizontalSection1->setLayout(new HorizontalSectionLayoutType('oneThirdRightColumn'));
$horizontalSectionsHorizontalSection1->setId('1');
$horizontalSectionsHorizontalSection1->setEmphasis(new SectionEmphasisType('none'));
$columnsHorizontalSectionColumn1 = new HorizontalSectionColumn();
$columnsHorizontalSectionColumn1->setId('1');
$columnsHorizontalSectionColumn1->setWidth(8);
$webpartsWebPart1 = new WebPart();
$webpartsWebPart1->setId('6f9230af-2a98-4952-b205-9ede4f9ef548');
$additionalData = [
	'innerHtml' => '<p><b>Hello!</b></p>',
];
$webpartsWebPart1->setAdditionalData($additionalData);
$webpartsArray []= $webpartsWebPart1;
$columnsHorizontalSectionColumn1->setWebparts($webpartsArray);

$columnsArray []= $columnsHorizontalSectionColumn1;
$columnsHorizontalSectionColumn2 = new HorizontalSectionColumn();
$columnsHorizontalSectionColumn2->setId('2');
$columnsHorizontalSectionColumn2->setWidth(4);
$webpartsWebPart1 = new WebPart();
$webpartsWebPart1->setId('73d07dde-3474-4545-badb-f28ba239e0e1');
$additionalData = [
'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',
					],
				],
			],
	],
],
];
$webpartsWebPart1->setAdditionalData($additionalData);
$webpartsArray []= $webpartsWebPart1;
$columnsHorizontalSectionColumn2->setWebparts($webpartsArray);

$columnsArray []= $columnsHorizontalSectionColumn2;
$horizontalSectionsHorizontalSection1->setColumns($columnsArray);

$horizontalSectionsArray []= $horizontalSectionsHorizontalSection1;
$canvasLayout->setHorizontalSections($horizontalSectionsArray);

$requestBody->setCanvasLayout($canvasLayout);

$result = $graphServiceClient->sites()->bySiteId('site-id')->pages()->post($requestBody)->wait();

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


Import-Module Microsoft.Graph.Beta.Sites

$params = @{
	"@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 = 
		title = "sample1"
	}
	canvasLayout = @{
		horizontalSections = @(
			@{
				layout = "oneThirdRightColumn"
				id = "1"
				emphasis = "none"
				columns = @(
					@{
						id = "1"
						width = 
						webparts = @(
							@{
								id = "6f9230af-2a98-4952-b205-9ede4f9ef548"
								innerHtml = "<p><b>Hello!</b></p>"
							}
						)
					}
					@{
						id = "2"
						width = 
						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 = 
										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 = 
										imgHeight = 
										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"
												}
											}
										)
									}
								}
							}
						)
					}
				)
			}
		)
	}
}

New-MgBetaSitePage -SiteId $siteId -BodyParameter $params

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.site_page import SitePage
from msgraph_beta.generated.models.page_layout_type import PageLayoutType
from msgraph_beta.generated.models.title_area import TitleArea
from msgraph_beta.generated.models.title_area_layout_type import TitleAreaLayoutType
from msgraph_beta.generated.models.title_area_text_alignment_type import TitleAreaTextAlignmentType
from msgraph_beta.generated.models.canvas_layout import CanvasLayout
from msgraph_beta.generated.models.horizontal_section import HorizontalSection
from msgraph_beta.generated.models.horizontal_section_layout_type import HorizontalSectionLayoutType
from msgraph_beta.generated.models.section_emphasis_type import SectionEmphasisType
from msgraph_beta.generated.models.horizontal_section_column import HorizontalSectionColumn
from msgraph_beta.generated.models.web_part import WebPart
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = SitePage(
	odata_type = "#microsoft.graph.sitePage",
	name = "test.aspx",
	title = "test",
	page_layout = PageLayoutType.Article,
	show_comments = True,
	show_recommended_pages = False,
	title_area = TitleArea(
		enable_gradient_effect = True,
		image_web_url = "https://cdn.hubblecontent.osi.office.net/m365content/publish/005292d6-9dcc-4fc5-b50b-b2d0383a411b/image.jpg",
		layout = TitleAreaLayoutType.ColorBlock,
		show_author = True,
		show_published_date = False,
		show_text_block_above_title = False,
		text_above_title = "TEXT ABOVE TITLE",
		text_alignment = TitleAreaTextAlignmentType.Left,
		additional_data = {
				"image_source_type" : 2,
				"title" : "sample1",
		}
	),
	canvas_layout = CanvasLayout(
		horizontal_sections = [
			HorizontalSection(
				layout = HorizontalSectionLayoutType.OneThirdRightColumn,
				id = "1",
				emphasis = SectionEmphasisType.None,
				columns = [
					HorizontalSectionColumn(
						id = "1",
						width = 8,
						webparts = [
							WebPart(
								id = "6f9230af-2a98-4952-b205-9ede4f9ef548",
								additional_data = {
										"inner_html" : "<p><b>Hello!</b></p>",
								}
							),
						],
					),
					HorizontalSectionColumn(
						id = "2",
						width = 4,
						webparts = [
							WebPart(
								id = "73d07dde-3474-4545-badb-f28ba239e0e1",
								additional_data = {
										"web_part_type" : "d1d91016-032f-456d-98a4-721247c305e8",
										"data" : {
												"data_version" : "1.9",
												"description" : "Show an image on your page",
												"title" : "Image",
												"properties" : {
														"image_source_type" : 2,
														"alt_text" : "",
														"overlay_text" : "",
														"siteid" : "0264cabe-6b92-450a-b162-b0c3d54fe5e8",
														"webid" : "f3989670-cd37-4514-8ccb-0f7c2cbe5314",
														"listid" : "bdb41041-eb06-474e-ac29-87093386bb14",
														"uniqueid" : "d9f94b40-78ba-48d0-a39f-3cb23c2fe7eb",
														"img_width" : 4288,
														"img_height" : 2848,
														"fix_aspect_ratio" : False,
														"caption_text" : "",
														"alignment" : "Center",
												},
												"server_processed_content" : {
														"image_sources" : [
															{
																	"key" : "imageSource",
																	"value" : "/_LAYOUTS/IMAGES/VISUALTEMPLATEIMAGE1.JPG",
															},
														],
														"custom_metadata" : [
															{
																	"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",
																	},
															},
														],
												},
										},
								}
							),
						],
					),
				],
			),
		],
	),
)

result = await graph_client.sites.by_site_id('site-id').pages.post(request_body)

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

Si se realiza correctamente, este método devuelve una 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.

Comentarios

¿Le ha resultado útil esta página?

Se actualizó por última vez el 2026-08-18

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

Permissions

Solicitud HTTP

Encabezados de solicitud

Cuerpo de la solicitud

Respuesta

Ejemplo

Solicitud

Respuesta

Comentarios

Recursos adicionales