Method: customers.reports.findSaasUsage

Recherchez les rapports d'utilisation SaaS d'un client en fonction des critères de recherche et de tri fournis.

Requête HTTP

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

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
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 ramenées à 200.
pageToken

string

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

Lors de la pagination, tous les autres paramètres fournis à FindSaasUsageReports doivent correspondre à l'appel ayant fourni le jeton de page.
filter

string

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

Champs pris en charge :

  • application
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • catégorie
  • organisation
  • foundedYear
  • siège social
  • primaryDomain
  • domaines
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

Exemple : (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

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

Champs pris en charge :

  • application
  • catégorie
  • organisation
  • foundedYear
  • siège social
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

Exemple : visitsCount 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.findSaasUsage.

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

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

object (SaasUsageReport)

Liste des rapports d'utilisation 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 d'utilisation 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

SaasUsageReport

Représente une seule entrée de rapport SaaS.

Représentation JSON 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
Champs
app

string

Uniquement en sortie. Nom de l'application.
orgUnitId

string

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

string

Uniquement en sortie. Catégorie de l'application.
organization

string

Uniquement en sortie. Organisation qui développe l'application.
foundedYear

integer

Uniquement en sortie. Année de création de l'organisation.
headquarters

string

Uniquement en sortie. Siège social de l'organisation.
primaryDomain

string

Uniquement en sortie. Domaine principal de l'application.
domains[]

string

Uniquement en sortie. Liste des domaines et sous-domaines associés à l'application.
encryptionProtocols[]

string

Uniquement en sortie. Liste des protocoles de chiffrement utilisés pour accéder à l'application.
visitsCount

string (int64 format)

Uniquement en sortie. Nombre total de visites de l'application.
distinctUsersCount

string (int64 format)

Uniquement en sortie. Nombre d'utilisateurs distincts ayant visité l'application.
distinctBrowsersCount

string (int64 format)

Uniquement en sortie. Nombre de navigateurs distincts ayant visité l'application.
contentTransferDetails

object (ContentTransferDetails)

Uniquement en sortie. Fournit des informations sur les événements de transfert de contenu, le cas échéant.
firstNavigationTime

string (Timestamp format)

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

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.

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".

ContentTransferDetails

Fournit des informations sur les événements de transfert de contenu, le cas échéant.

Représentation JSON 
{
  "contentTransferCount": string
}
Champs
contentTransferCount

string (int64 format)

Uniquement en sortie. Nombre total de transferts de contenu associés à l'application.