Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Obtenha todos os objetos callTranscript de instâncias de chamada ad hoc iniciadas por um usuário específico. Essa API permite que você acesse e analise, de forma programática, transcrições de reuniões para chamadas organizadas por um determinado usuário, filtradas por intervalos de datas opcionais.
Disponibilidade da API
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Sem suporte. | Sem suporte. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | CallTranscripts.Read.All | Indisponível. |
Solicitação HTTP
GET /users/{usersId}/adhocCalls/getAllTranscripts(userId={userId},startDateTime={startDateTime},endDateTime={endDateTime})
Parâmetros de função
Forneça os seguintes parâmetros de função com valores na URL solicitada.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| endDateTime | DateTimeOffset | Opcional. Filtre artefatos criados antes da data de término determinada. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2025 é 2025-01-01T00:00:00Z. |
| startDateTime | DateTimeOffset | Opcional. Filtre por artefatos criados após a data de início especificada. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2025 é 2025-01-01T00:00:00Z. |
| userId | Cadeia de caracteres | O identificador de usuário do organizador da reunião para filtrar artefatos para reuniões organizadas pelo identificador de usuário fornecido. Obrigatório. |
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedida, essa função retornará um código de 200 OK resposta e uma coleção callTranscript no corpo da resposta.
Respostas de erros
Essa API é regida pelas configurações do administrador de locatários para acesso à transcrição. Ramifique no innerError.code valor, não no texto da mensagem — as mensagens estão sujeitas a alterações.
| Status | Código de erro (innerError.code) |
Condition |
|---|---|---|
403 Forbidden |
GraphAccessToTranscriptsDisabled |
Um administrador de locatários desativou o acesso da API do Graph às transcrições. Nenhuma nova tentativa é bem-sucedida até que o acesso seja reativado. |
O transcriptContentUrl retornado por esta função aponta para o ponto de extremidade de transcrição /content , que também está sujeito à configuração de atribuição de alto-falante do locatário. Para esse erro e um exemplo de conteúdo de erro, consulte Get callTranscript.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/adhocCalls/getAllTranscripts(userId=d4220f1b-4c12-436c-8a03-dc3e362f9d54,startDateTime=2025-10-07T07:25:21.9730833Z,endDateTime=2025-10-07T07:25:52.4130833Z)
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/v1.0/$metadata#users('d4220f1b-4c12-436c-8a03-dc3e362f9d54')/adhocCalls",
"@odata.count": 2,
"value": [
{
"id": "ktVizJ7GAAAAoPCPlATZWzE5OmNkYWQ5MTQ4LWQ5MjYtNDczMS04NjE4LTM3MWU1ODdkZGVkMF9kNDIyMGYxYi00YzEyLTQzNmMtOGEwMy1kYzNlMzYyZjlkNTRAdW5xLmdibC5zcGFjZXOg2TxmYjdlNWMxZS04YWI4LTQ2NDctOTdhMS03Mzk5MDhkNDE3YjMtMTc1OTgyMTkyMS1UcmFuc2NyaXB0VjI=",
"meetingId": null,
"callId": "fb7e5c1e-8ab8-4647-97a1-739908d417b3",
"contentCorrelationId": "7cc3ae2a-0aa9-4e47-9d85-e98e607d1af2-20251007_072521",
"transcriptContentUrl": "https://graph.microsoft.com/v1.0/users/d4220f1b-4c12-436c-8a03-dc3e362f9d54/adhocCalls/fb7e5c1e-8ab8-4647-97a1-739908d417b3/transcripts/ktVizJ7GAAAAoPCPlATZWzE5OmNkYWQ5MTQ4LWQ5MjYtNDczMS04NjE4LTM3MWU1ODdkZGVkMF9kNDIyMGYxYi00YzEyLTQzNmMtOGEwMy1kYzNlMzYyZjlkNTRAdW5xLmdibC5zcGFjZXOg2TxmYjdlNWMxZS04YWI4LTQ2NDctOTdhMS03Mzk5MDhkNDE3YjMtMTc1OTgyMTkyMS1UcmFuc2NyaXB0VjI=/content",
"createdDateTime": "2025-10-07T07:25:21.9730833Z",
"endDateTime": "2025-10-07T07:25:52.4130833Z",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "d4220f1b-4c12-436c-8a03-dc3e362f9d54",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
}
}
},
{
"id": "ktVizJ7GAAAAoPCPlATZWzE5OmNkYWQ5MTQ4LWQ5MjYtNDczMS04NjE4LTM3MWU1ODdkZGVkMF9kNDIyMGYxYi00YzEyLTQzNmMtOGEwMy1kYzNlMzYyZjlkNTRAdW5xLmdibC5zcGFjZXOg2TwwNTQ3ZDUzOS0wNTExLTRiZDEtODRjZi01YTA3M2ZhYjcxMmQtMTc1OTgxODY3My1UcmFuc2NyaXB0VjI=",
"meetingId": null,
"callId": "0547d539-0511-4bd1-84cf-5a073fab712d",
"contentCorrelationId": "94c3eb48-4271-4b60-b7b7-121b9d798eb3-20251007_063113",
"transcriptContentUrl": "https://graph.microsoft.com/v1.0/users/d4220f1b-4c12-436c-8a03-dc3e362f9d54/adhocCalls/0547d539-0511-4bd1-84cf-5a073fab712d/transcripts/ktVizJ7GAAAAoPCPlATZWzE5OmNkYWQ5MTQ4LWQ5MjYtNDczMS04NjE4LTM3MWU1ODdkZGVkMF9kNDIyMGYxYi00YzEyLTQzNmMtOGEwMy1kYzNlMzYyZjlkNTRAdW5xLmdibC5zcGFjZXOg2TwwNTQ3ZDUzOS0wNTExLTRiZDEtODRjZi01YTA3M2ZhYjcxMmQtMTc1OTgxODY3My1UcmFuc2NyaXB0VjI=/content",
"createdDateTime": "2025-10-07T06:31:13.1759028Z",
"endDateTime": "2025-10-07T06:31:26.5759028Z",
"meetingOrganizer": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "d4220f1b-4c12-436c-8a03-dc3e362f9d54",
"displayName": null,
"userIdentityType": "aadUser",
"tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
}
}
}
]
}