Compartilhar via


Listar participants_v2

Namespace: microsoft.graph.callRecords

Obtenha a lista de objetos de participantes associados a uma chamadaRegisto.

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

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application CallRecords.Read.All Indisponível.

Solicitação HTTP

GET /communications/callRecords/{id}/participants_v2

Parâmetros de consulta opcionais

Este método suporta o seguinte parâmetro de consulta OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.

Nome Descrição
$select Use o parâmetro de consulta $select para retornar um conjunto de propriedades diferente do padrão definido para um recurso individual ou um conjunto de recursos.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Preferir: odata.maxpagesize={x} Especifica um tamanho de página {x} de número inteiro preferencial para resultados paginados. Este valor tem de ser igual ou inferior ao tamanho máximo de página permitido. Opcional.
Preferir: include-unknown-enum-members Permite valores de enumeração evoluíveis para além do valor do sentinel. Para obter mais informações, veja Melhores práticas para trabalhar com o Microsoft Graph. Opcional.
Preferir: omit-values=nulls Remove valores nulos ou vazios da resposta. Opcional.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e uma coleção de objetos microsoft.graph.callRecords.participant no corpo da resposta.

Quando um conjunto de resultados abrange várias páginas, o Microsoft Graph devolve essa página com uma propriedade @odata.nextLink na resposta que contém um URL para a página seguinte de resultados. Se essa propriedade estiver presente, continue a fazer pedidos adicionais com o URL @odata.nextLink em cada resposta, até que todos os resultados sejam devolvidos. Para mais informações, consulte Paginação de dados do Microsoft Graph em seu aplicativo. O tamanho máximo da página para os participantes é de 130 entradas.

Exemplos

Solicitação

O exemplo seguinte mostra um pedido para obter a lista de objetos de participante para uma chamadaRegisto.

GET https://graph.microsoft.com/v1.0/communications/callRecords/614e3ff0-4728-4394-8c03-52fb3b967fde/participants_v2

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

{
  "@odata.context": "https://graph.microsoft.com/$metadata#communications/callRecords('614e3ff0-4728-4394-8c03-52fb3b967fde')/participants_v2",
  "@odata.nextLink": "https://graph.microsoft.com/v1.0/communications/callRecords/614e3ff0-4728-4394-8c03-52fb3b967fde/participants_v2",
  "value": [
    {
      "id": "00005994-851d-4988-bbc3-413bbf089e13",
      "identity": {
        "acsUser": null,
        "spoolUser": null,
        "phone": null,
        "guest": null,
        "encrypted": null,
        "onPremises": null,
        "acsApplicationInstance": null,
        "spoolApplicationInstance": null,
        "applicationInstance": null,
        "application": null,
        "device": null,
        "user": {
          "@odata.type": "#microsoft.graph.userIdentity",
          "id": "00005994-851d-4988-bbc3-413bbf089e13",
          "displayName": "Anette Thomsen",
          "tenantId": "dc368399-474c-4d40-900c-6265431fd81f",
          "userPrincipalName": "anette.thomsen@contoso.com"
        }
      }
    },
    {
      "id": "13fd6bf0-f646-4b82-b0ad-cd28ce10d6e3",
      "identity": {
        "acsUser": null,
        "spoolUser": null,
        "phone": null,
        "guest": null,
        "encrypted": null,
        "onPremises": null,
        "acsApplicationInstance": null,
        "spoolApplicationInstance": null,
        "applicationInstance": null,
        "application": null,
        "device": null,
        "user": {
          "@odata.type": "#microsoft.graph.userIdentity",
          "id": "13fd6bf0-f646-4b82-b0ad-cd28ce10d6e3",
          "displayName": "Daichi Maruyama",
          "tenantId": "dc368399-474c-4d40-900c-6265431fd81f",
          "userPrincipalName": "daichi.maruyama@contoso.com"
        }
      }
    }
  ]
}