Exemples de code pour l'API Chrome Management Chrome Browsers

Consultez la page API Chrome Management Chrome Browsers pour obtenir une présentation des fonctionnalités de l'API.

Toutes les requêtes affichées sur cette page utilisent les variables suivantes :

  • $TOKEN : jeton OAuth 2.0
  • $CUSTOMER : ID du client ou littéral my_customer

Lister les navigateurs Chrome enregistrés

Pour lister les navigateurs Chrome enregistrés, utilisez le point de terminaison /chromeBrowsers. Vous pouvez contrôler la pagination à l'aide des paramètres pageSize (100 par défaut et au maximum) et pageToken. Utilisez orderBy pour spécifier l'ordre des résultats. Spécifiez un filter pour affiner les résultats. Un masque de lecture peut être spécifié avec le paramètre de requête fields.

La correspondance avec caractère générique (*) (préfixe prefix*, suffixe *suffix, sous-chaîne *substring* ou présence *) est acceptée avec = et : uniquement dans les champs machine_name, annotated_asset_id et browser_version.

La recherche de texte globale (sans spécifier de nom de champ) s'effectue dans tous les champs de texte indexés. Lorsque plusieurs termes sont séparés par AND ou un espace (par exemple, filter=machine AND 73 ou filter=machine 73), chaque terme doit correspondre à au moins un champ de texte indexé sur l'appareil du navigateur (même sur différents champs). Si vous placez plusieurs mots entre guillemets (par exemple, filter="machine name"), vous recherchez cette expression contiguë exacte dans un seul champ.

Exemples de requêtes de filtre

# Filter by machine name prefix (using ':' or '=')
filter=machine_name:LIX*

# Filter by annotated asset ID suffix
filter=annotated_asset_id="*1001"

# Filter by browser version substring
filter=browser_version:"*6367*"

# Global search across all indexed text fields (matches browsers containing both "machine" and "73" across any fields)
filter=machine AND 73

# Global search with implicit AND (equivalent to `machine AND 73`)
filter=machine 73

# Filter by machine name prefix and registration time range
filter=machine_name:LIX* AND last_registration_time>=2024-01-01T00:00:00Z

# Filter by Organizational Unit path
filter=org_unit_path=/Marketing

Requête

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers?pageSize=2&orderBy=lastActivityTime+desc&filter=os_platform=WINDOWS"

Réponse

{
  "chromeBrowsers": [
    {
      "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
      "browserPermanentId": "<browserPermanentId1>",
      "machineName": "CLIENT2024-01",
      "osPlatformType": "WINDOWS",
      "osVersion": "10.0.19045",
      "browserVersion": "124.0.6367.60",
      "annotatedUser": "user1@example.com",
      "annotatedLocation": "US-NYC",
      "annotatedAssetId": "ASSET-1001",
      "annotatedNotes": "Engineering workstation",
      "lastActivityTime": "2024-04-23T22:05:44.214362Z",
      "lastPolicySyncTime": "2024-04-23T22:00:00.000Z",
      "lastStatusReportTime": "2024-04-23T22:05:44.214362Z",
      "enrollmentDate": "2024-01-15T10:30:00.000Z",
      "orgUnitPath": "/Engineering",
      "policyCount": 15,
      "extensionCount": 8
    },
    {
      "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId2>",
      "browserPermanentId": "<browserPermanentId2>",
      "machineName": "CLIENT2024-02",
      "osPlatformType": "WINDOWS",
      "osVersion": "11.0.22631",
      "browserVersion": "124.0.6367.60",
      "annotatedUser": "user2@example.com",
      "annotatedLocation": "US-MTV",
      "lastActivityTime": "2024-04-23T21:45:10.102000Z",
      "lastPolicySyncTime": "2024-04-23T21:40:00.000Z",
      "lastStatusReportTime": "2024-04-23T21:45:10.102000Z",
      "enrollmentDate": "2024-02-10T14:15:00.000Z",
      "orgUnitPath": "/Engineering",
      "policyCount": 12,
      "extensionCount": 5
    }
  ],
  "nextPageToken": "<nextPageToken>"
}

Récupérer un navigateur Chrome géré

Pour récupérer un seul navigateur Chrome enregistré, utilisez le point de terminaison /chromeBrowsers/{browser_permanent_id}. Un masque de lecture peut être spécifié avec le paramètre fields.

Requête

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>"

Réponse

{
  "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
  "browserPermanentId": "<browserPermanentId1>",
  "machineName": "CLIENT2024-01",
  "osPlatformType": "WINDOWS",
  "osVersion": "10.0.19045",
  "browserVersion": "124.0.6367.60",
  "annotatedUser": "user1@example.com",
  "annotatedLocation": "US-NYC",
  "annotatedAssetId": "ASSET-1001",
  "annotatedNotes": "Engineering workstation",
  "lastActivityTime": "2024-04-23T22:05:44.214362Z",
  "lastPolicySyncTime": "2024-04-23T22:00:00.000Z",
  "lastStatusReportTime": "2024-04-23T22:05:44.214362Z",
  "enrollmentDate": "2024-01-15T10:30:00.000Z",
  "orgUnitPath": "/Engineering",
  "policyCount": 15,
  "extensionCount": 8
}

Mettre à jour les informations sur les annotations pour un navigateur Chrome

Pour mettre à jour les champs annotés d'un navigateur Chrome enregistré, utilisez le point de terminaison /chromeBrowsers/{browser_permanent_id} avec la méthode HTTP PATCH et fournissez un paramètre de requête updateMask spécifiant les champs à mettre à jour.

Requête

  curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>?updateMask=annotatedUser,annotatedNotes" \
  -d '{
    "annotatedUser": "newuser@example.com",
    "annotatedNotes": "Updated primary workstation"
  }'

Réponse

{
  "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
  "browserPermanentId": "<browserPermanentId1>",
  "machineName": "CLIENT2024-01",
  "osPlatformType": "WINDOWS",
  "osVersion": "10.0.19045",
  "browserVersion": "124.0.6367.60",
  "annotatedUser": "newuser@example.com",
  "annotatedLocation": "US-NYC",
  "annotatedAssetId": "ASSET-1001",
  "annotatedNotes": "Updated primary workstation",
  "lastActivityTime": "2024-04-23T22:05:44.214362Z",
  "orgUnitPath": "/Engineering"
}

Déplacer des navigateurs Chrome vers une autre unité organisationnelle

Pour déplacer des navigateurs Chrome gérés d'une unité organisationnelle vers une autre, utilisez le point de terminaison /chromeBrowsers:move. Vous pouvez déplacer jusqu'à 600 navigateurs par requête. Si une erreur se produit lors du déplacement d'un navigateur, aucun des navigateurs spécifiés n'est déplacé.

Requête

  curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers:move" \
  -d '{
    "destinationOrgUnitId": "03ph8a2z3v",
    "resourceIds": [
      "customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>",
      "customers/$CUSTOMER/chromeBrowsers/<browserPermanentId2>"
    ]
  }'

Réponse

{}

Supprimer les données collectées à partir d'un navigateur Chrome

Pour supprimer les données collectées à partir d'un navigateur Chrome géré, utilisez le point de terminaison /chromeBrowsers/{browser_permanent_id} avec HTTP DELETE.

Requête

  curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>"

Réponse

{}