Compartilhar via


externalItem: addActivities

Espaço de nomes: microsoft.graph.externalConnectors

Acrescente instâncias adicionais de objetos externalActivity num externalItem.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte.
Application ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All

Solicitação HTTP

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON dos parâmetros.

A tabela a seguir mostra os parâmetros que podem ser usados com esta ação.

Parâmetro Tipo Descrição
activities coleção microsoft.graph.externalConnectors.externalActivity Coleção de atividades que envolvem um externalItem.

Resposta

Se for bem-sucedida, esta ação devolve um 200 OK código de resposta e uma coleção de objetos microsoft.graph.externalConnectors.externalActivityResult no corpo da resposta.

Um 207 Multi-Status código de resposta indica que apenas algumas das instâncias externalActivity adicionadas foram processadas com êxito. O autor da chamada deve inspecionar o payload da resposta, analisando o campo de erro de cada externalActivityResult para determinar por que motivo a instância externalActivity não foi processada e que ação pode ser tomada. Uma null propriedade de erro indica um externalActivityResult bem-sucedido.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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