Compartilhar via

copilotReportRoot: getMicrosoft365CopilotUsageUserDetail

Importante

As APIs na /beta versão estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção.

Obtenha os dados de utilização mais recentes para utilizadores que estão ativados para aplicações Microsoft 365 Copilot.

Para obter mais informações sobre vistas e nomes de relatórios, consulte Relatórios do Microsoft 365 - Microsoft 365 Copilot utilização. As APIs de relatórios de utilização copilot estão disponíveis como APIs REST padrão no espaço de nomes do Microsoft Graph. Para obter mais informações, veja Descrição geral Microsoft 365 Copilot APIs.

Observação

Esta API só devolve dados de utilização para utilizadores com uma licença de Microsoft 365 Copilot. Os dados de utilização de Copilot Chat não licenciados não estão disponíveis através das APIs de relatórios do Microsoft Graph. Em vez disso, pode:

  • Ver a utilização não licenciada no relatório de Utilização de Copilot Chat do Centro de Administração Microsoft 365
  • Aceder a dados de auditoria através do Registo de Auditoria do Microsoft Purview
  • Exportar programaticamente com Search-UnifiedAuditLog o (PowerShell) ou a API de Atividade de Gestão do Office 365

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
Delegada (conta corporativa ou de estudante) Reports.Read.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Reports.Read.All Indisponível.

Importante

Para permissões delegadas para permitir que as aplicações leiam relatórios de utilização de serviços em nome de um utilizador, o administrador inquilino tem de ter atribuído ao utilizador uma das seguintes Microsoft Entra ID funções de administrador limitadas:

  • Administrador da Empresa
  • Administrador de IA
  • Administrador do Exchange
  • Administrador do SharePoint
  • Administrador do Lync
  • Administrador de Serviço do Teams
  • Administrador de Comunicações do Teams
  • Leitor Global
  • Leitor de relatórios de resumo do uso
  • Leitor de Relatórios

Para obter mais informações, veja Autorização para APIs para ler relatórios de utilização do Microsoft 365.

Solicitação HTTP

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail

Parâmetros de função

Na URL da solicitação, forneça os seguintes parâmetros de consulta com valores.

Parâmetro Tipo Descrição
period Cadeia de caracteres O número de dias anteriores para comunicar a utilização agregada. Os valores suportados são: D7, , D30, D90, D180. ALL Os primeiros quatro valores seguem o formato DN, em que n representa o número de dias anteriores para agregar dados. ALL indica para reportar a utilização de 7, 30, 90 e 180 dias.

Cabeçalhos de solicitação

Nome Descrição
Authorization Bearer {token}. 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, esta função devolve um 200 OK código de resposta e um fluxo no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')?$format=application/json

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')?$format=application/json

Resposta

O exemplo a seguir mostra a resposta. O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.

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

{
  "value": [
    {
      "reportRefreshDate": "2025-08-20",
      "userPrincipalName": "DC8C64D6EC3A3AA17481D7E5EB5B68A6",
      "displayName": "C65E8D8AFA0DAB9639EDFAAEA94AFE66",
      "lastActivityDate": "2025-08-20",
      "copilotChatLastActivityDate": "2025-08-16",
      "microsoftTeamsCopilotLastActivityDate": "2025-08-20",
      "wordCopilotLastActivityDate": "2025-08-06",
      "excelCopilotLastActivityDate": "",
      "powerPointCopilotLastActivityDate": "2025-03-26",
      "outlookCopilotLastActivityDate": "",
      "oneNoteCopilotLastActivityDate": "",
      "loopCopilotLastActivityDate": "",
      "copilotActivityUserDetailsByPeriod": [
        {
          "reportPeriod": 7
        }
      ]
    }
  ]
}
  • Last updated on