contentType: addCopyFromContentTypeHub

  • Статья

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Добавление или синхронизация копии опубликованного типа контента из концентратора типов контента с целевым сайтом или списком.

Этот метод является частью публикации изменений типов контента для оптимизации синхронизации опубликованных типов контента с сайтами и списками, эффективно переключаясь с подхода "отправить везде" на "потянуть по мере необходимости". Метод позволяет пользователям извлекать типы контента непосредственно из концентратора типов контента на сайт или список. Дополнительные сведения см. в разделе getCompatibleHubContentTypes и записи блога Syntex Product Обновления – август 2021 г.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

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

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

HTTP-запрос

POST /sites/{siteId}/lists/{listId}/contentTypes/addCopyFromContentTypeHub
POST /sites/{siteId}/contentTypes/addCopyFromContentTypeHub

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

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

Текст запроса

В тексте запроса укажите представление параметров в формате JSON.

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

Параметр Тип Описание
contentTypeId String Идентификатор типа контента в концентраторе типов контента, который должен быть добавлен на целевой сайт или в список.

Отклик

В случае успешного 200 OK выполнения это действие возвращает код отклика и объект contentType в тексте ответа, если тип контента добавляется синхронно, или 202 Accepted код ответа, если тип контента будет синхронно синхронно. Ответ также будет содержать Location заголовок, содержащий расположение объекта richLongRunningOperation , созданного для обработки копирования и синхронизации. В случае асинхронной операции синхронизация или добавление типа контента может занять до 70 минут.

Примеры

Пример 1. Синхронное извлечение

Запрос

POST https://graph.microsoft.com/beta/sites/{siteId}/lists/{listId}/contentTypes/addCopyFromContentTypeHub
Content-Type: application/json
Content-length: 33

{
  "contentTypeId": "0x0101"
}

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
    "@odata.type": "#microsoft.graph.contentType",
    "id": "0x0101",
    "description": "Document content type",
    "group": "Document Content Types",
    "hidden": false,
    "isBuiltIn": true,
    "name": "Document"
}

Пример 2. Асинхронное извлечение

Запрос

POST https://graph.microsoft.com/beta/sites/{siteId}/lists/{listId}/contentTypes/addCopyFromContentTypeHub
Content-Type: application/json
Content-length: 33

{
  "contentTypeId": "String"
}

Отклик

HTTP/1.1 202 Accepted
location: https://graph.microsoft.com/beta/sites/{siteId}/lists/{listId}/operations/{operationId}