Тип ресурса site
Пространство имен: microsoft.graph
Ресурс site предоставляет метаданные и связи для сайта SharePoint.
Методы
| Метод | Тип возвращаемых данных | Описание |
|---|---|---|
| Получение корневого сайта | site | Получение доступа к корневому сайту SharePoint внутри клиента. |
| Получение сайта | site | Получение доступа к сайту SharePoint с помощью параметра siteId. |
| Перечисление сайтов по географическим регионам | коллекция сайтов | Перечисление сайтов по всем географическим регионам в организации. |
| Вывод списка дочерних сайтов для сайта | коллекция сайтов | Вы можете получить коллекцию дочерних сайтов, определенных для сайта. |
| Получение сайта по пути | site | Получение доступа к корневому сайту SharePoint с использованием относительного пути. |
| Получение сайта для группы | site | Получение доступа к сайту группы для группы. |
| Получение аналитики | itemAnalytics | Получение аналитических данных для ресурса. |
| Получение действий по интервалу | itemActivityStat | Получение коллекции объектов itemActivityStats в пределах указанного интервала времени. |
| Получение дельты | Коллекция объектов site | Получение только что созданных, обновленных или удаленных сайтов без необходимости полного считывания всего семейства сайтов. |
| Поиск сайтов | коллекция сайтов | Поиск сайтов, соответствующих предоставленным ключевым словам, в клиенте SharePoint. |
| Отслеживание сайта | коллекция сайтов | Отслеживание сайта пользователя или нескольких сайтов. |
| Прекращение отслеживания сайта | коллекция сайтов | Отслеживание сайта пользователя или нескольких сайтов. |
| Перечисление отслеживаемых сайтов | коллекция сайтов | Список сайтов, за которыми следует пользователь, выполнившего вход. |
| Получение разрешения | GET /sites/{site-id}/permissions/{permission-id} | |
| Список разрешений | GET /sites/{site-id}/permissions | |
| Создание разрешений | POST /sites/{site-id}/permissions | |
| Удаление разрешения | DELETE /sites/{site-id}/permissions/{permission-id} | |
| Обновление разрешения | PATCH /sites/{site-id}/permissions/{permission-id} | |
| Операции со списком | Коллекция richLongRunningOperation | Получите список длительных операций связанных с сайтом. |
| Перечисление страниц | GET /sites/{site-id}/pages |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| createdDateTime | DateTimeOffset | Дата и время создания элемента. Только для чтения. |
| description | string | Текст с описанием сайта. |
| displayName | string | Полное название сайта. Только для чтения. |
| eTag | string | ETag для элемента. Только для чтения. |
| id | string | Уникальный идентификатор элемента. Только для чтения. |
| isPersonalSite | логический | Определяет, является ли сайт личным или нет. Только для чтения. |
| lastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения элемента. Только для чтения. |
| name | string | Имя или заголовок элемента. |
| root | root | При наличии предоставляет корневой сайт в семействе веб-сайтов. Только для чтения. |
| sharepointIds | sharepointIds | Возвращает идентификаторы, использующиеся для обеспечения совместимости с SharePoint REST. Только для чтения. |
| siteCollection | siteCollection | Предоставляет сведения о семействе веб-сайтов сайта. Доступно только на корневом сайте. Только для чтения. |
| webUrl | строка (url-адрес) | URL-адрес для отображения элемента в браузере. Только для чтения. |
Свойство id
Ресурс site идентифицируется посредством уникального идентификатора, при создании которого используются следующие значения:
- имя узла семейства веб-сайтов (contoso.sharepoint.com);
- уникальный идентификатор семейства веб-сайтов (GUID);
- уникальный идентификатор сайта (GUID).
Идентификатор root всегда ссылается на корневой сайт указанного целевого объекта, как показано ниже.
-
/sites/root. Корневой сайт клиента. -
/groups/{group-id}/sites/root. Сайт группы для ресурса group.
Связи
| Связь | Тип | Описание |
|---|---|---|
| analytics | Ресурс itemAnalytics | Аналитика о действиях просмотра, которые имели место на этом сайте. |
| columns | Collection(columnDefinition) | Коллекция определений столбцов, которые можно повторно использовать в разных списках на этом сайте. |
| contentTypes | Collection(contentType) | Коллекция типов контента, определенных для этого сайта. |
| drive | drive | Диск по умолчанию (библиотека документов) для этого сайта. |
| drives | Collection(drive) | Коллекция дисков (библиотек документов) на этом сайте. |
| items | Collection(baseItem) | Используется для адресации любого элемента, содержащегося на этом сайте. Невозможно перечислить эту коллекцию. |
| lists | Collection(list) | Коллекция списков на этом сайте. |
| onenote | onenote | Вызывает службу OneNote для выполнения операций, связанных с записными книжками. |
| operations | Коллекция richLongRunningOperation | Коллекция длительных операций на сайте. |
| pages | Collection(baseSitePage) | Коллекция страниц в списке baseSitePages на этом сайте. |
| permissions | Collection(permission) | Разрешения, связанные с сайтом. Допускается значение NULL. |
| sites | Collection(site) | Коллекция дочерних сайтов этого сайта. |
| termStore | microsoft.graph.termStore.store | TermStore по умолчанию на этом сайте. |
| termStores | Коллекция(microsoft.graph.termStore.store) | Коллекция termStores на этом сайте. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
Ресурс site является производным от ресурса baseItem и наследует его свойства.
{
"id": "string",
"isPersonalSite": "bool",
"root": { "@odata.type": "microsoft.graph.root" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"siteCollection": {"@odata.type": "microsoft.graph.siteCollection"},
"displayName": "string",
/* relationships */
"analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
"contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
"drive": { "@odata.type": "microsoft.graph.drive" },
"drives": [ { "@odata.type": "microsoft.graph.drive" }],
"items": [ { "@odata.type": "microsoft.graph.baseItem" }],
"lists": [ { "@odata.type": "microsoft.graph.list" }],
"operations": [ { "@odata.type": "microsoft.graph.richLongRunningOperation" }],
"permissions": [ { "@odata.type": "microsoft.graph.permission" }],
"sites": [ { "@odata.type": "microsoft.graph.site"} ],
"columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
"onenote": { "@odata.type": "microsoft.graph.onenote"},
"termStore": { "@odata.type": "microsoft.graph.termStore.store" },
"termStores": [ { "@odata.type": "microsoft.graph.termStore.store" } ],
/* inherited from baseItem */
"name": "string",
"createdDateTime": "datetime",
"description": "string",
"eTag": "string",
"lastModifiedDateTime": "datetime",
"webUrl": "url"
}