Obter um recurso de site

Namespace: microsoft.graph

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(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados
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

Observação

Quando um usuário de uma localização geográfica tenta acessar um site localizado em outra área geográfica, a solicitação pode falhar, a menos que o usuário que está chamando tenha pelo menos a permissão de "Acesso limitado" para o conjunto de sites raiz da área geográfica de destino. Certifique-se de que o acesso seja concedido para evitar problemas de autorização.

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

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Exemplos

Exemplo 1: Obter um site usando a ID do site

Solicitação

O exemplo a seguir mostra uma solicitação que obtém um site por sua ID de site. Uma ID do site é o valor da propriedade id de seu recurso de site . Para obter mais informações sobre o formato da ID do site, consulte site.

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE


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

// 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}"].GetAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
sites, err := graphClient.Sites().BySiteId("site-id").Get(context.Background(), nil)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Site result = graphClient.sites().bySiteId("{site-id}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let site = await client.api('/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


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


$result = $graphServiceClient->sites()->bySiteId('site-id')->get()->wait();


Import-Module Microsoft.Graph.Sites

Get-MgSite -SiteId $siteId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.sites.by_site_id('site-id').get()

Resposta

O exemplo a seguir mostra a resposta.

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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "isPersonalSite": false,
  "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 servidor URL relativa

Solicitação

O exemplo a seguir mostra uma solicitação que obtém um site por seu nome de host e caminho relativo do servidor.

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/teams/1drvteam

Resposta

O exemplo a seguir mostra a 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

O exemplo a seguir mostra uma solicitação que obtém o site de um grupo pela propriedade id de um grupo.

GET https://graph.microsoft.com/v1.0/groups/2C712604-1370-44E7-A1F5-426573FDA80A/sites/root


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

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



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
sites, err := graphClient.Groups().ByGroupId("group-id").Sites().BySiteId("site-id").Get(context.Background(), nil)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Site result = graphClient.groups().byGroupId("{group-id}").sites().bySiteId("{site-id}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let site = await client.api('/groups/2C712604-1370-44E7-A1F5-426573FDA80A/sites/root')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


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


$result = $graphServiceClient->groups()->byGroupId('group-id')->sites()->bySiteId('site-id')->get()->wait();


Import-Module Microsoft.Graph.Sites

Get-MgGroupSite -GroupId $groupId -SiteId $siteId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.groups.by_group_id('group-id').sites.by_site_id('site-id').get()

Resposta

O exemplo a seguir mostra a 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

Esta página foi útil?

Last updated on 2026-08-24

Obter um recurso de site

Permissões

Solicitação HTTP

Obter o site raiz do locatário

Acesse um site pela URL relativa do servidor

Acesse um site de equipe do grupo

Cabeçalhos de solicitação

Exemplos

Exemplo 1: Obter um site usando a ID do site

Solicitação

Resposta

Exemplo 2: obter um site por servidor URL relativa

Solicitação

Resposta

Exemplo 3: Obter o site de um grupo

Solicitação

Resposta

Comentários

Recursos adicionais