API Chrome Management Chrome Browsers

L'API Chrome Management Chrome Browsers permet aux administrateurs d'afficher les données et de gérer les navigateurs Chrome enregistrés dans Chrome Enterprise Core. Cet ensemble d'API permet de lister les navigateurs Chrome enregistrés, de récupérer un navigateur Chrome, de mettre à jour les informations d'annotation d'un navigateur Chrome, de déplacer des navigateurs Chrome entre des unités organisationnelles (UO) et de supprimer la collecte des données à partir d'un navigateur Chrome.

Présentation rapide des méthodes d'API

Les URL sont relatives à https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Description URL relative Méthode HTTP
Lister les navigateurs Chrome enregistrés /chromeBrowsers GET
Récupérer un navigateur Chrome /chromeBrowsers/{browser_permanent_id} GET
Mettre à jour les informations d'annotation d'un navigateur Chrome /chromeBrowsers/{browser_permanent_id} PATCH
Déplacer des navigateurs Chrome vers une nouvelle unité organisationnelle (UO) /chromeBrowsers:move POST
Supprimer les données collectées à partir d'un navigateur Chrome /chromeBrowsers/{browser_permanent_id} SUPPRIMER

Consultez des exemples de code pour obtenir des exemples de requêtes et de réponses.

Filtrage des résultats…

Lorsque vous listez les navigateurs Chrome avec la méthode /chromeBrowsers, vous pouvez affiner les résultats à l'aide du paramètre de requête filter. Tous les paramètres de filtre doivent être échappés par URL lorsqu'ils sont envoyés dans des requêtes HTTP. Vous pouvez combiner plusieurs conditions à l'aide de l'opérateur AND.

  • Champs de type chaîne, entier et énumération : compatible avec les opérateurs de comparaison = et :. Le caractère générique * (préfixe prefix*, suffixe *suffix, sous-chaîne *substring* ou présence *) n'est compatible avec = et : que pour machine_name, annotated_asset_id et browser_version (par exemple, machine_name=LIX* ou browser_version:"*6367*"). Le filtrage de littéraux de chaîne globaux sans fioritures (sans nom de champ) est également possible : un seul terme tel que ABC correspond si un champ de chaîne indexé contient ABC, et plusieurs termes joints par AND ou un espace (par exemple, machine AND 73 ou machine 73) correspondent aux navigateurs qui contiennent chaque terme spécifié dans l'un de leurs champs de texte indexés (alors qu'une seule chaîne de plusieurs mots entre guillemets, telle que "machine 73", correspond à l'expression contiguë exacte dans un seul champ).
  • Champs de code temporel : acceptent les opérateurs de comparaison =, <= et >=. Les codes temporels attendent une chaîne au format RFC-3339 entre guillemets (par exemple, "2020-01-01T12:00:00Z" ou "2012-04-21T11:30:00-04:00"). Les plages de codes temporels fermées peuvent être spécifiées à l'aide de comparaisons.
  • Filtrage par unité organisationnelle : vous pouvez filtrer les navigateurs appartenant à une unité organisationnelle spécifique en spécifiant org_unit_path (par exemple, org_unit_path=/Marketing). La correspondance avec une seule unité organisationnelle est acceptée.
  • Filtrage par groupe : vous pouvez filtrer les navigateurs appartenant à un groupe Cloud Identity spécifique à l'aide de la fonction in_group (par exemple, in_group("groups/00gjdgxs0lm8l7o")).

Champs acceptant le filtrage

Champ Description
browser_permanent_id Identifiant unique permanent de l'appareil avec navigateur Chrome.
last_policy_fetch_time Date et heure de la dernière récupération de règle pour l'appareil avec navigateur Chrome.
os_platform Plate-forme d'OS de l'appareil avec navigateur Chrome (par exemple, WINDOWS, MAC, LINUX).
os_architecture Architecture de l'OS de l'appareil avec navigateur Chrome
os_version Version du système d'exploitation de l'appareil avec navigateur Chrome
machine_name Nom de la machine associée à l'appareil avec navigateur Chrome.
annotated_location Emplacement annoté pour l'appareil avec navigateur Chrome.
annotated_user Utilisateur annoté de l'appareil avec navigateur Chrome.
annotated_asset_id ID d'élément annoté pour l'appareil avec navigateur Chrome.
annotated_note Notes annotées pour l'appareil avec navigateur Chrome.
org_unit_path Chemin d'accès à l'unité organisationnelle de l'appareil avec navigateur Chrome (par exemple, /Marketing).
org_unit_id ID de l'unité organisationnelle de l'appareil avec navigateur Chrome.
last_registration_time Date et heure d'enregistrement de l'appareil avec navigateur Chrome.
os_platform_version Plate-forme d'OS et version majeure de l'appareil avec navigateur Chrome.
browser_version Version du navigateur Chrome renvoyée pour l'appareil.
last_status_report_time Date et heure du dernier rapport d'état pour l'appareil avec navigateur Chrome.
extension_count Nombre d'extensions installées sur l'appareil avec navigateur Chrome.
policy_count Nombre de règles appliquées à l'appareil avec navigateur Chrome.
last_device_user Le dernier utilisateur connecté à l'appareil.
last_activity_time Dernière fois que l'appareil avec navigateur Chrome a présenté une activité (récupération de règle ou création de rapport).
device_id_collision Indique si l'ID de l'appareil est partagé par plusieurs machines identifiées par le navigateur Chrome comme une seule et même machine (true ou false).

Filter functions

Fonction Description
in_group(string) Filtre la liste des appareils avec navigateur Chrome pour n'inclure que ceux appartenant au nom de ressource du groupe Cloud Identity spécifié (format : in_group("groups/{group_id}")).

Classement des résultats

Vous pouvez spécifier l'ordre des résultats à l'aide du paramètre de requête orderBy. Par défaut, le tri est effectué par ordre croissant. Pour spécifier l'ordre décroissant d'un champ, ajoutez le suffixe " desc" au nom du champ (par exemple, last_activity_time desc).

Si aucune valeur n'est spécifiée, l'ordre par défaut est l'ordre croissant de browser_permanent_id.

Champs de tri compatibles

  • browser_permanent_id
  • last_policy_fetch_time
  • annotated_user
  • annotated_location
  • annotated_asset_id
  • annotated_notes
  • org_unit_path
  • os_version
  • last_registration_time
  • extension_count
  • policy_count
  • last_device_user
  • machine_name
  • browser_version_channel
  • os_platform_version
  • last_activity_time
  • browser_version

Droits d'administrateur

L'API Chrome Browsers respecte la délégation des rôles d'administrateur.

Méthode Droits d'administrateur requis
ListChromeBrowsers "Services -> Gestion de Chrome -> Paramètres -> Navigateurs gérés"
ou "Services -> Gestion de Chrome -> Paramètres -> Navigateurs gérés -> Lire"
GetChromeBrowser "Services -> Gestion de Chrome -> Paramètres -> Navigateurs gérés"
ou "Services -> Gestion de Chrome -> Paramètres -> Navigateurs gérés -> Lire"
UpdateChromeBrowser "Services -> Gestion de Chrome -> Paramètres -> Navigateurs gérés"
MoveChromeBrowsers "Services -> Gestion de Chrome -> Paramètres -> Navigateurs gérés"
DeleteChromeBrowser "Services -> Gestion de Chrome -> Paramètres -> Navigateurs gérés"

Pour gérer les rôles et les droits d'administrateur, accédez à "Console d'administration > Rôles d'administrateur".

Champs d'application de l'API

L'API Chrome Management Chrome Browsers nécessite les champs d'application OAuth suivants :

Méthode Champs d'application OAuth requis
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
ou https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
ou https://www.googleapis.com/auth/chrome.management.browsers.readonly
UpdateChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
MoveChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
DeleteChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers

Pour en savoir plus, consultez la page Présentation de l'authentification.