Method: customers.reports.findSaasUsageProfiles

Recherchez les rapports sur l'utilisation de SaaS d'un client regroupés par profils en fonction des critères de recherche et de tri fournis.

Requête HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsageProfiles

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customer

string

Obligatoire. ID client obscurci, précédé de "customers/C" ou "customers/my_customer".

Paramètres de requête

Paramètres
app

string

Obligatoire. Nom de l'application SaaS (par exemple, ChatGPT, Gemini).
pageSize

integer

Facultatif. Nombre maximal de rapports à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 100 rapports au maximum sont renvoyés. La valeur maximale est 200. Les valeurs supérieures à 200 sont forcées à 200.
pageToken

string

Facultatif. Jeton de page reçu d'un appel reports.findSaasUsageProfiles précédent. Fournissez-le pour récupérer la page suivante.
filter

string

Facultatif. Expression de filtre permettant de limiter les rapports sur les profils SaaS à renvoyer. Les opérateurs compatibles sont : =, !=, <, <=, >, >=, :. Les opérateurs logiques AND, OR et NOT sont compatibles.

Champs compatibles :

  • e-mail
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

Facultatif. Expression de tri permettant de trier les rapports sur les profils SaaS.

Champs compatibles :

  • e-mail
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

L'ordre par défaut est croissant. Pour spécifier un ordre décroissant pour un champ, ajoutez " desc".

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse à la méthode reports.findSaasUsageProfiles.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "profileReports": [
    {
      object (SaasUsageProfileReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Champs
profileReports[]

object (SaasUsageProfileReport)

Liste des rapports sur les profils d'utilisation de SaaS.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.
totalSize

string (int64 format)

Nombre total de rapports sur les profils d'utilisation de SaaS correspondant à la requête.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

SaasUsageProfileReport

Représente une seule entrée de rapport SaaS regroupée par profil.

Représentation JSON 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Champs
email

string

Uniquement en sortie. Adresse e-mail de l'utilisateur.
profilePermanentId

string

Uniquement en sortie. ID permanent du profil.
firstNavigationTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la première navigation vers l'application par ce profil.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la dernière navigation vers l'application par ce profil.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
orgUnitId

string

Uniquement en sortie. ID de l'unité organisationnelle.
osPlatform

enum (DeviceSystem)

Uniquement en sortie. Plate-forme du système d'exploitation.
osVersion

string

Uniquement en sortie. Version de l'OS.