reportRoot: getOffice365GroupsActivityCountsreportRoot: getOffice365GroupsActivityCounts

Obtenha o número de atividades de grupo em todas as cargas de trabalho de grupo.Get the number of group activities across group workloads.

Observação: para saber mais sobre diferentes visualizações e nomes de relatórios, confira Relatórios do Office 365 Reports - Grupos do Office 365.Note: For details about different report views and names, see Office 365 Reports - Office 365 groups.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account) Reports.Read.AllReports.Read.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Reports.Read.AllReports.Read.All

Observação: para permissões delegadas para permitir que os aplicativos leiam relatórios de uso do serviço em nome de um usuário, o administrador do locatário deve ter atribuído ao usuário a função de administrador limitada do Azure ad apropriada.Note: For delegated permissions to allow apps to read service usage reports on behalf of a user, the tenant administrator must have assigned the user the appropriate Azure AD limited administrator role. Para obter mais detalhes, consulte Authorization for APIs to read Office 365 Usage Reports.For more details, see Authorization for APIs to read Office 365 usage reports.

Solicitação HTTPHTTP request

GET /reports/getOffice365GroupsActivityCounts(period='{period_value}')

Parâmetros de funçãoFunction parameters

Na URL da solicitação, forneça um valor válido ao seguinte parâmetro.In the request URL, provide the following parameter with a valid value.

ParâmetroParameter TipoType DescriçãoDescription
pontoperiod cadeia de caracteresstring Especifica o período de tempo durante o qual o relatório é agregado.Specifies the length of time over which the report is aggregated. Os valores com suporte para {period_value} são: D7, D30, D90 e D180.The supported values for {period_value} are: D7, D30, D90, and D180. Eles seguem o formato Dn, em que n representa o número de dias em que o relatório é agregado.These values follow the format Dn where n represents the number of days over which the report is aggregated. Obrigatório.Required.

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
If-None-MatchIf-None-Match Se este cabeçalho de solicitação estiver incluso e a eTag fornecida corresponder à marca atual do arquivo, um código de resposta 304 Not Modified será exibido.If this request header is included and the eTag provided matches the current tag on the file, a 304 Not Modified response code is returned. Opcional.Optional.

RespostaResponse

Se for bem-sucedido, este método retorna uma resposta 302 Found que redireciona para uma URL de download pré-autenticada para o relatório.If successful, this method returns a 302 Found response that redirects to a preauthenticated download URL for the report. Essa URL pode ser encontrada no cabeçalho Location na resposta.That URL can be found in the Location header in the response.

As URLs de download previamente autenticadas são válidas apenas por um curto período de tempo (alguns minutos) e não exigem um cabeçalho Authorization.Preauthenticated download URLs are only valid for a short period of time (a few minutes) and do not require an Authorization header.

O arquivo CSV possui os seguintes cabeçalhos para colunas.The CSV file has the following headers for columns.

  • Data de atualização do relatórioReport Refresh Date
  • Emails recebidos do ExchangeExchange Emails Received
  • Mensagens postadas do YammerYammer Messages Posted
  • Mensagens lidas do YammerYammer Messages Read
  • Mensagens curtidas do YammerYammer Messages Liked
  • Data do relatórioReport Date
  • Período de RelatórioReport Period

ExemploExample

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/reports/getOffice365GroupsActivityCounts(period='D7')

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

Siga o redirecionamento 302 e o arquivo CSV baixado terá o seguinte esquema.Follow the 302 redirection and the CSV file that downloads will have the following schema.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,Exchange Emails Received,Yammer Messages Posted,Yammer Messages Read,Yammer Messages Liked,Report Date,Report Period