Obter um recurso de site

Artigo
04/08/2023

Recupere as propriedades e as relações de um recurso de site. Um recurso site representa um site de equipe no SharePoint.

Um site é endereçado para ser um identificador exclusivo que é uma ID composta dos seguintes valores:

Hostname do conjunto de sites (contoso.sharepoint.com)
ID exclusiva do conjunto de sites (GUID)
ID exclusiva do site (GUID)

Há também um identificador de site reservado, root, que sempre faz referência ao site raiz de um determinado destino da seguinte maneira:

/sites/root: O site raiz do locatário.
/groups/{group-id}/sites/root: O site da equipe do grupo.

Além disso, o site raiz de uma instância geográfica específica (para locatários multi-geográficos) pode ser acessado com o dataLocationCode da geografia, da seguinte maneira:

/sites/NAM: o site raiz da instância norte-americana do locatário
/sites/EUR: o site raiz da instância europeia do locatário

Permissões

Uma das permissões a seguir é necessária para chamar essa 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.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Sites.Read.All, Sites.ReadWrite.All

Obter o site raiz do locatário

Para acessar o site raiz do SharePoint dentro de um locatário:

GET /sites/root
GET /sites/contoso.sharepoint.com
GET /sites/JPN

Acesse um site pela URL relativa do servidor

Se você tiver a URL relativa do servidor para um recurso site, crie uma solicitação da seguinte maneira:

GET /sites/{hostname}:/{server-relative-path}

Acesse um site de equipe do grupo

Para acessar o site de equipe de um grupo:

GET /groups/{group-id}/sites/root

Exemplo

Solicitação

GET /sites/{site-id}

Resposta

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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "displayName": "OneDrive Team Site",
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}

Compartilhar via