Obter um recurso de site
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 Versão.
Recupere as propriedades e as relações de um recurso de site. Um recurso site representa um site de equipe no SharePoint.
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Sites.Read.All | Sites.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sites.Read.All | Sites.ReadWrite.All |
Solicitação HTTP
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
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
Exemplos
Exemplo 1: obter um site usando a ID do site
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",
"owner": {
"user": {
"displayName": "Daron Spektor",
"id": "5280E7FE-DC7A-4486-9490-E790D81DFEB3"
}
},
"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"
}
Exemplo 2: Obter um site por URL relativa do servidor
Solicitação
GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{server-relative-path}
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"
}
Exemplo 3: Obter o site de um grupo
Solicitação
GET https://graph.microsoft.com/v1.0/groups/{group-id}/sites/root
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"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de