Method: customers.reports.findSaasUsageBrowsers

Recherchez les rapports d'utilisation de SaaS d'un client regroupés par navigateur en fonction des critères de recherche et de tri spécifiés.

Requête HTTP

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

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 navigateurs à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 100 navigateurs au maximum seront renvoyés. La valeur maximale est 200. Les valeurs supérieures à 200 seront forcées à 200.

pageToken

string

Facultatif. Jeton de page reçu d'un appel reports.findSaasUsageBrowsers 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 navigateurs SaaS à renvoyer. Les opérateurs compatibles sont : =, !=, <, <=, >, >=, :. Les opérateurs logiques AND, OR et NOT sont compatibles.

Champs compatibles :

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

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

Champs compatibles :

  • machine
  • 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.findSaasUsageBrowsers.

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

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

object (SaasUsageBrowser)

Liste des rapports sur les navigateurs utilisant SaaS.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante.

totalSize

string (int64 format)

Nombre total de rapports sur les navigateurs utilisant SaaS qui correspondent à 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

SaasUsageBrowser

Détails d'un navigateur utilisant SaaS.

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

string

Uniquement en sortie. Nom de la machine.

devicePermanentId

string

Uniquement en sortie. ID permanent de l'appareil.

firstNavigationTime

string (Timestamp format)

Uniquement en sortie. Timestamp indiquant la première fois que ce navigateur a accédé à 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. Timestamp indiquant la dernière fois que ce navigateur a accédé à 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".

orgUnitId

string

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

osPlatform

enum (DeviceSystem)

Uniquement en sortie. Plate-forme de l'OS.

osVersion

string

Uniquement en sortie. Version de l'OS.