Получение ресурса site
Пространство имен: 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. Получение сайта с помощью идентификатора сайта
Запрос
GET https://graph.microsoft.com/v1.0/sites/{site-id}
Отклик
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/{hostname}:/{server-relative-path}
Отклик
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. Получение сайта группы
Запрос
GET https://graph.microsoft.com/v1.0/groups/{group-id}/sites/root
Отклик
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"
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по