Compartilhar via

copilotReportRoot: getMicrosoft365CopilotUserCountSummary

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 o número agregado de utilizadores ativos e ativados de Microsoft 365 Copilot durante um período de tempo especificado.

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.

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/getMicrosoft365CopilotUserCountSummary

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

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 durante os quais 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 Stream no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountSummary(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: 537

{
  "value": [
    {
      "reportRefreshDate": "2025-08-20",
      "adoptionByProduct": [
        {
          "reportPeriod": 7,
          "anyAppEnabledUsers": 359229,
          "anyAppActiveUsers": 165115,
          "microsoftTeamsEnabledUsers": 359096,
          "microsoftTeamsActiveUsers": 123341,
          "wordEnabledUsers": 359096,
          "wordActiveUsers": 21459,
          "powerPointEnabledUsers": 359096,
          "powerPointActiveUsers": 8530,
          "outlookEnabledUsers": 359096,
          "outlookActiveUsers": 37270,
          "excelEnabledUsers": 359096,
          "excelActiveUsers": 6709,
          "oneNoteEnabledUsers": 359096,
          "oneNoteActiveUsers": 1660,
          "loopEnabledUsers": 359096,
          "loopActiveUsers": 1345,
          "copilotChatEnabledUsers": 359096,
          "copilotChatActiveUsers": 65480
        }
      ]
    }
  ]
}
  • Last updated on