Method: customers.reports.findInstalledAppDevices

Générer un rapport sur les appareils Chrome gérés sur lesquels une application spécifique est installée

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customer

string

Obligatoire. Identifiant client ou "my_customer" pour utiliser le client associé au compte à l'origine de la demande.

Paramètres de requête

Paramètres
orgUnitId

string

ID de l'unité organisationnelle.
appId

string

Identifiant unique de l'application. Pour les applications et les extensions Chrome, l'identifiant à 32 caractères (ehoadneljpdggcbbknedodolkkjodefl, par exemple). Pour les applications Android : nom du package (par exemple, com.evernote).
appType

enum (AppType)

Type d'application.
pageSize

integer

Nombre maximal de résultats sur une page. La valeur maximale et la valeur par défaut sont 100.
pageToken

string

Jeton permettant de spécifier la page de la requête à renvoyer.
orderBy

string

Champ utilisé pour classer les résultats.

Champs "Trier par" acceptés:

  • machine
  • deviceId
filter

string

Chaîne de requête permettant de filtrer les résultats, champs séparés par l'opérateur ET dans la syntaxe EBNF.

Remarque: Les opérations OR ne sont pas compatibles avec ce filtre.

Champs de filtre compatibles:

  • last_active_date

Corps de la requête

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

Corps de la réponse

Réponse contenant la liste des appareils sur lesquels l'application interrogée est installée.

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

Représentation JSON 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Champs
devices[]

object (Device)

Liste des appareils sur lesquels l'application est installée. Triée par ordre alphabétique croissant sur le champ Device.machine.
nextPageToken

string

Jeton permettant de spécifier la page suivante de la requête.
totalSize

integer

Nombre total d'appareils correspondant à la demande.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Appareil

Décrit un appareil qui fournit des informations sur le navigateur Chrome.

Représentation JSON 
{
  "deviceId": string,
  "machine": string
}
Champs
deviceId

string

Uniquement en sortie. ID de l'appareil ayant envoyé ces informations sur le navigateur Chrome.
machine

string

Uniquement en sortie. Nom de la machine au sein de son réseau local.