Criar uma página na lista de páginas do site de um site

Artigo
07/18/2022
5 minutos para o fim da leitura

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

Criar um novo sitePage na lista de páginas [do][] site em um site.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Sites.ReadWrite.All

Solicitação HTTP

POST /sites/{site-id}/pages

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON do [recurso sitePage][] a ser criado.

Exemplo

O exemplo a seguir mostra como criar uma nova página.

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

{
    "name": "Events.aspx",
    "title": "Team Events",
    "publishingState": {
        "level": "checkedOut",
        "versionId": "0.1"
    },
    "webParts": [
        {
            "type": "rte",
            "data": {
                "innerHTML": "<p>Here are the team's upcoming events:</p>"
            }
        },
        {
            "type": "d1d91016-032f-456d-98a4-721247c305e8",
            "data": {
                "title": "Events",
                "description": "Display upcoming events",
                "serverProcessedContent": {
                    "htmlStrings": {},
                    "searchablePlainTexts": {
                        "title": ""
                    },
                    "imageSources": {},
                    "links": {
                        "baseUrl": "https://www.contoso.com/sites/Engineering"
                    },
                    "componentDependencies": {
                        "layoutComponentId": "8ac0c53c-e8d0-4e3e-87d0-7449eb0d4027"
                    }
                },
                "dataVersion": "1.0",
                "properties": {
                    "selectedListId": "032e08ab-89b0-4d8f-bc10-73094233615c",
                    "selectedCategory": "",
                    "dateRangeOption": 0,
                    "startDate": "",
                    "endDate": "",
                    "isOnSeeAllPage": false,
                    "layoutId": "FilmStrip",
                    "dataProviderId": "Event",
                    "webId": "0764c419-1ecc-4126-ba32-0c25ae0fffe8",
                    "siteId": "6b4ffc7a-cfc2-4a76-903a-1cc3686dee23"
                }
            }
        }
    ]
}


const options = {
    authProvider,
};

const client = Client.init(options);

const sitePage = {
    name: 'Events.aspx',
    title: 'Team Events',
    publishingState: {
        level: 'checkedOut',
        versionId: '0.1'
    },
    webParts: [
        {
            type: 'rte',
            data: {
                innerHTML: '<p>Here are the team\'s upcoming events:</p>'
            }
        },
        {
            type: 'd1d91016-032f-456d-98a4-721247c305e8',
            data: {
                title: 'Events',
                description: 'Display upcoming events',
                serverProcessedContent: {
                    htmlStrings: {},
                    searchablePlainTexts: {
                        title: ''
                    },
                    imageSources: {},
                    links: {
                        baseUrl: 'https://www.contoso.com/sites/Engineering'
                    },
                    componentDependencies: {
                        layoutComponentId: '8ac0c53c-e8d0-4e3e-87d0-7449eb0d4027'
                    }
                },
                dataVersion: '1.0',
                properties: {
                    selectedListId: '032e08ab-89b0-4d8f-bc10-73094233615c',
                    selectedCategory: '',
                    dateRangeOption: 0,
                    startDate: '',
                    endDate: '',
                    isOnSeeAllPage: false,
                    layoutId: 'FilmStrip',
                    dataProviderId: 'Event',
                    webId: '0764c419-1ecc-4126-ba32-0c25ae0fffe8',
                    siteId: '6b4ffc7a-cfc2-4a76-903a-1cc3686dee23'
                }
            }
        }
    ]
};

await client.api('/sites/{site-id}/pages')
    .version('beta')
    .post(sitePage);

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não dão suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var sitePage = new SitePage
{
    Name = "Events.aspx",
    Title = "Team Events",
    PublishingState = new PublicationFacet
    {
        Level = "checkedOut",
        VersionId = "0.1"
    },
    WebParts = new List<WebPart>()
    {
        new WebPart
        {
            Type = "rte",
            Data = new SitePageData
            {
                AdditionalData = new Dictionary<string, object>()
                {
                    {"innerHTML", "<p>Here are the team's upcoming events:</p>"}
                }
            }
        },
        new WebPart
        {
            Type = "d1d91016-032f-456d-98a4-721247c305e8",
            Data = new SitePageData
            {
                AdditionalData = new Dictionary<string, object>()
                {
                    {"title", "Events"},
                    {"description", "Display upcoming events"},
                    {"serverProcessedContent", "{\"htmlStrings\":{},\"searchablePlainTexts\":{\"title\":\"\"},\"imageSources\":{},\"links\":{\"baseUrl\":\"https://www.contoso.com/sites/Engineering\"},\"componentDependencies\":{\"layoutComponentId\":\"8ac0c53c-e8d0-4e3e-87d0-7449eb0d4027\"}}"},
                    {"dataVersion", "1.0"},
                    {"properties", "{\"selectedListId\":\"032e08ab-89b0-4d8f-bc10-73094233615c\",\"selectedCategory\":\"\",\"dateRangeOption\":0,\"startDate\":\"\",\"endDate\":\"\",\"isOnSeeAllPage\":false,\"layoutId\":\"FilmStrip\",\"dataProviderId\":\"Event\",\"webId\":\"0764c419-1ecc-4126-ba32-0c25ae0fffe8\",\"siteId\":\"6b4ffc7a-cfc2-4a76-903a-1cc3686dee23\"}"}
                }
            }
        }
    }
};

await graphClient.Sites["{site-id}"].Pages
    .Request()
    .AddAsync(sitePage);

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewSitePage()
name := "Events.aspx"
requestBody.SetName(&name)
title := "Team Events"
requestBody.SetTitle(&title)
publishingState := msgraphsdk.NewPublicationFacet()
requestBody.SetPublishingState(publishingState)
level := "checkedOut"
publishingState.SetLevel(&level)
versionId := "0.1"
publishingState.SetVersionId(&versionId)
requestBody.SetWebParts( []WebPart {
    msgraphsdk.NewWebPart(),
type := "rte"
    SetType(&type)
data := msgraphsdk.NewSitePageData()
    SetData(data)
    data.SetAdditionalData(map[string]interface{}{
        "innerHTML": "<p>Here are the team's upcoming events:</p>",
    }
    msgraphsdk.NewWebPart(),
type := "d1d91016-032f-456d-98a4-721247c305e8"
    SetType(&type)
data := msgraphsdk.NewSitePageData()
    SetData(data)
    data.SetAdditionalData(map[string]interface{}{
        "title": "Events",
        "description": "Display upcoming events",
        "dataVersion": "1.0",
    }
}
siteId := "site-id"
result, err := graphClient.SitesById(&siteId).Pages().Post(requestBody)

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.


Import-Module Microsoft.Graph.Sites

$params = @{
    Name = "Events.aspx"
    Title = "Team Events"
    PublishingState = @{
        Level = "checkedOut"
        VersionId = "0.1"
    }
    WebParts = @(
        @{
            Type = "rte"
            Data = @{
                InnerHTML = "<p>Here are the team's upcoming events:</p>"
            }
        }
        @{
            Type = "d1d91016-032f-456d-98a4-721247c305e8"
            Data = @{
                Title = "Events"
                Description = "Display upcoming events"
                DataVersion = "1.0"
            }
        }
    )
}

New-MgSitePage -SiteId $siteId -BodyParameter $params

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

Resposta

Se tiver êxito, este método retornará [um sitePage][] no corpo da resposta para a página criada.

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

{
    "id": "2",
    "eTag": "75bc70e2-6587-45be-8493-c99a956b2e05,7",
    "createdDateTime": "2016-12-06T20:04:40Z",
    "lastModifiedDateTime": "2016-12-06T20:05:09Z",
    "webUrl": "https://www.contoso.com/sites/Engineering/SitePages/Events.aspx",
    "createdBy": {
        "user": {
            "email": "rahmit",
            "id": "1b37d2e1-5000-4648-b431-7dfa509b5660",
            "displayName": "Rahul Mittal"
        }
    },
    "lastModifiedBy": {
        "user": {
            "email": "rahmit",
            "id": "1b37d2e1-5000-4648-b431-7dfa509b5660",
            "displayName": "Rahul Mittal"
        }
    },
    "parentReference": {
        "id": "eb3bfd48-56f8-4c1e-8312-e58588b22e7c"
    },
    "contentType": {
        "id": "0x0101009D1CB255DA76424F860D91F20E6C411800C9E7033636784C4B88A284B1823C45FD",
        "name": "Site Page"
    },
    "description": "",
    "title": "Team Events",
    "webParts": [
        {
            "type": "rte",
            "data": {
                "innerHTML": "<p>Here are the team's upcoming events:</p>"
            }
        },
        {
            "type": "d1d91016-032f-456d-98a4-721247c305e8",
            "data": {
                "title": "Events",
                "description": "Display upcoming events",
                "serverProcessedContent": {
                    "htmlStrings": {},
                    "searchablePlainTexts": {
                        "title": ""
                    },
                    "imageSources": {},
                    "links": {
                        "baseUrl": "https://www.contoso.com/teams/Engineering"
                    },
                    "componentDependencies": {
                        "layoutComponentId": "8ac0c53c-e8d0-4e3e-87d0-7449eb0d4027"
                    }
                },
                "dataVersion": "1.0",
                "properties": {
                    "selectedListId": "032e08ab-89b0-4d8f-bc10-73094233615c",
                    "selectedCategory": "",
                    "dateRangeOption": 0,
                    "startDate": "",
                    "endDate": "",
                    "isOnSeeAllPage": false,
                    "layoutId": "FilmStrip",
                    "dataProviderId": "Event",
                    "webId": "0764c419-1ecc-4126-ba32-0c25ae0fffe8",
                    "siteId": "6b4ffc7a-cfc2-4a76-903a-1cc3686dee23"
                }
            }
        }
    ]
}

Observação: O objeto Response será truncado para mais clareza. As propriedades padrão serão retornadas da chamada real.

Criar uma página na lista de páginas do site de um site

Permissões

Solicitação HTTP

Corpo da solicitação

Exemplo

Resposta

Comentários