Получение ресурса site

Статья
12/18/2024

Пространство имен: microsoft.graph

Вы можете получить свойства и связи ресурса site. Ресурс site представляет сайт группы в SharePoint.

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	Sites.Read.All	Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Для приложений	Sites.Read.All	Sites.ReadWrite.All

HTTP-запрос

Получение корневого сайта клиента

Чтобы получить доступ к корневому сайту SharePoint внутри клиента, создайте следующие запросы:

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

Использование относительного URL-адреса сервера для доступа к сайту

Если у вас есть относительный URL-адрес сервера для ресурса site, можно создать следующий запрос:

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

Доступ к сайту группы для группы

Чтобы получить доступ к сайту группы для группы, создайте следующий запрос:

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

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Примеры

Пример 1. Получение сайта с помощью идентификатора сайта

Запрос

В следующем примере показан запрос, который получает сайт по его идентификатору сайта. Идентификатор сайта — это значение свойства id ресурса сайта . Дополнительные сведения о формате идентификатора сайта см. в разделе 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();



mgc sites get --site-id {site-id}



// 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()

Отклик

Ниже показан пример отклика.

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"
}

Пример 2. Получение сайта по URL-адресу относительно сервера

Запрос

В следующем примере показан запрос, который получает сайт по имени узла и пути относительно сервера.

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

Отклик

Ниже показан пример отклика.

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"
}

Пример 3. Получение сайта группы

Запрос

В следующем примере показан запрос, который получает сайт группы по свойству idгруппы.

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();



mgc groups sites get --group-id {group-id} --site-id {site-id}



// 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()

Отклик

Ниже приводится пример отклика.

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"
}

Поделиться через

Получение ресурса site

Разрешения

HTTP-запрос

Получение корневого сайта клиента

Использование относительного URL-адреса сервера для доступа к сайту

Доступ к сайту группы для группы

Заголовки запросов

Примеры

Пример 1. Получение сайта с помощью идентификатора сайта

Запрос

Отклик

Пример 2. Получение сайта по URL-адресу относительно сервера

Запрос

Отклик

Пример 3. Получение сайта группы

Запрос

Отклик

Обратная связь

Дополнительные ресурсы