reportRoot : getOffice365GroupsActivityCountsreportRoot: getOffice365GroupsActivityCounts

Obtenir le nombre d’activités de groupe dans les charges de travail de groupe.Get the number of group activities across group workloads.

Remarque : pour plus d’informations sur les différents noms et vues de rapport, reportez-vous à l’article relatif aux rapports Office 365 - groupes Office 365.Note: For details about different report views and names, see Office 365 Reports - Office 365 groups.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Reports.Read.AllReports.Read.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Reports.Read.AllReports.Read.All

Requête HTTPHTTP request

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

Paramètres de fonctionFunction parameters

Dans l’URL de la requête, indiquez une valeur valide pour le paramètre suivant.In the request URL, provide the following parameter with a valid value.

ParamètreParameter TypeType DescriptionDescription
pointperiod stringstring Spécifie la durée de regroupement du rapport.Specifies the length of time over which the report is aggregated. Les valeurs prises en charge pour {period_value} sont les suivantes : D7, D30, D90 et D180.The supported values for {period_value} are: D7, D30, D90, and D180. Ces valeurs suivent le format Dn, où n représente le nombre de jours pendant lesquels le rapport est regroupé.These values follow the format Dn where n represents the number of days over which the report is aggregated. Obligatoire.Required.

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
If-None-MatchIf-None-Match Si cet en-tête de demande est inclus et que l’eTag fourni correspond à la balise actuelle sur le fichier, un code de réponse 304 Not Modified est renvoyé.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. Facultatif.Optional.

RéponseResponse

Si elle réussit, cette méthode renvoie une réponse 302 Found qui redirige vers une URL de téléchargement préalablement authentifiée pour le rapport.If successful, this method returns a 302 Found response that redirects to a preauthenticated download URL for the report. Cette URL est accessible dans l’en-tête Location de la réponse.That URL can be found in the Location header in the response.

Les URL de téléchargement préalablement authentifiées ne sont valides que pour une courte durée (quelques minutes) et ne nécessitent pas d’en-tête Authorization.Preauthenticated download URLs are only valid for a short period of time (a few minutes) and do not require an Authorization header.

Le fichier CSV comporte les en-têtes de colonnes suivants.The CSV file has the following headers for columns.

  • Date d’actualisation du rapportReport Refresh Date
  • Messages électroniques Exchange reçusExchange Emails Received
  • Messages Yammer publiésYammer Messages Posted
  • Messages Yammer lusYammer Messages Read
  • Messages Yammer aimésYammer Messages Liked
  • Date du rapportReport Date
  • Période du rapportReport Period

ExempleExample

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

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

RéponseResponse

Voici un exemple de réponse.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

Suivez la redirection 302 et le fichier CSV téléchargé aura le schéma suivant.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