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


externalItem: addActivities

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

Добавление дополнительных экземпляров объектов externalActivity в externalItem.

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

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

Разрешения

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

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

HTTP-запрос

POST external/connections/{connectionsId}/items/{externalItemId}/addActivities

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

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

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

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

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

Параметр Тип Описание
activities Коллекция microsoft.graph.externalConnectors.externalActivity Коллекция действий, связанных с externalItem.

Отклик

В случае успешного 200 OK выполнения это действие возвращает код отклика и коллекцию объектов microsoft.graph.externalConnectors.externalActivityResult в теле отклика.

Код 207 Multi-Status ответа указывает, что успешно обработаны только некоторые из добавленных экземпляров externalActivity . Вызывающий объект должен проверить полезные данные ответа, просмотрев поле ошибки для каждого объекта externalActivityResult , чтобы определить, почему экземпляр externalActivity не был обработан и какие действия можно предпринять. Свойство nullerror указывает на успешное выполнение externalActivityResult.

Примеры

Запрос

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

POST https://graph.microsoft.com/v1.0/external/connections/contosohr/items/TSP228082938/addActivities
Content-Type: application/json
Content-length: 190

{
  "activities": [
    {
      "@odata.type": "#microsoft.graph.externalConnectors.externalActivity",
      "type": "created",
      "startDateTime": "2021-04-06T18:04:31.033Z",
      "performedBy": {
        "type": "user",
        "id": "1f0c997e-99f7-43f1-8cca-086f8d42be8d"
      }
    }
  ]
}

Отклик

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

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.externalConnectors.externalActivityResult",
      "type": "created",
      "startDateTime": "2021-04-06T18:04:31.033Z",
      "error": null
    }
  ]
}