Notification

Vous prévoyez votre stratégie de retour au bureau ? Découvrez comment Chrome OS peut vous aider.

Configurer la gestion cloud du navigateur Chrome

Utiliser l'API Chrome Browser Cloud Management

Topics

Autorisation 

Avant d'utiliser toutes les API de gestion cloud du navigateur Chrome, vous devez activer l'API SDK Admin (si ce n'est pas déjà fait) dans la consoles pour les développeurs Google. Pour cela, cliquez sur ce lien et sélectionnez le projet sur lequel vous souhaitez activer l'API.

Ensuite, deux options s'offrent à vous pour obtenir un jeton afin d'accéder à l'API :

  1. OAuth2.0 avec emprunt d'identité via un compte de service (voir la section "Autoriser avec emprunt d'identité" ci-après)
  2. OAuth2.0 en 3 étapes sans emprunt d'identité (vous pouvez autoriser vos requêtes en suivant les consignes OAuth2).

Les habilitations suivantes sont nécessaires pour autoriser l'accès à l'API Chrome Browser Cloud Management :

https://www.googleapis.com/auth/admin.directory.device.chromebrowsers.readonly

ou

https://www.googleapis.com/auth/admin.directory.device.chromebrowsers

Autoriser avec emprunt d'identité

Pour utiliser un compte de service pour l'emprunt d'identité, vous devez :

  1.  Créer un compte de service et disposer des clés nécessaires pour ce compte de service. Suivez cette procédure pour créer un compte de service et obtenir les clés du compte de service. 
  2. L'ID client de ce compte de service devra être autorisé pour les habilitations OAuth répertoriées ci-dessus. Pour ce faire, vous devez accéder à la console d'administration sous Sécurité -> Commandes des API -> Gérer la délégation au niveau du domaine. Vous devez ensuite ajouter un nouveau client. Dans cette boîte de dialogue, l'ID client correspond à l'ID unique de votre compte de service.

Avec les clés de compte de service, vous devrez utiliser les bibliothèques clientes des API Google correspondant au langage de votre choix pour demander un jeton d'accès OAuth pour votre compte de service. 

 

Notez que la requête de jeton OAuth devra également emprunter l'identité d'un administrateur de votre domaine pour l'obtention du jeton. 

Voici un exemple de code qui utilise les bibliothèques clientes des API pour Java pour la récupération du jeton OAuth.

package takeout.api.credentials;

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;

public final class ApiRequestHelper {

  public static String getAccessToken(
      String serviceAccountKeyFilePath, String adminUserToImpersonate, Collection<String> scopes)
      throws IOException {
    InputStream is = new FileInputStream(serviceAccountKeyFilePath);

    GoogleCredential credential =
        GoogleCredential.fromStream(is).toBuilder()
            .setServiceAccountScopes(scopes)
            .setServiceAccountUser(adminUserToImpersonate)
            .build();

    if (!credential.refreshToken()) {
      throw new RuntimeException(
          String.format(
              "Failed to fetch refresh token for service account defined in '%s' for user '%s' and"
                  + " scopes '%s'",
              serviceAccountKeyFilePath, adminUserToImpersonate, String.join(",", scopes)));
    }
    return credential.getAccessToken();
  }

  public static void printUsage() {
    System.out.println(
        "Usage: get_access_token <service account key file> <admin user> [<scope,scope>]");
  }

  public static void main(String[] args) throws Exception {
    if (args.length < 2) {
      printUsage();
      return;
    }

    String scopes =
        "https://www.googleapis.com/auth/admin.directory.device.chromebrowsers";
    if (args.length >= 3) {
      scopes = args[2];
    }
    System.out.println(
        getAccessToken(args[0], args[1], new ArrayList<String>(Arrays.asList(scopes.split(",")))));
  }

  private ApiRequestHelper() {}
}

À l'aide de cet exemple de code, vous pouvez récupérer un jeton d'accès à utiliser pour appeler l'API. Par exemple, si votre fichier de clé est stocké dans /home/private_key.json et que le compte administrateur que vous souhaitez utiliser pour envoyer la requête est admin@domain.com, vous devez exécuter le code avec les arguments suivants :

ApiRequestHelper /home/private_key.json admin@domain.com

 

Remarque : L'adresse e-mail de l'administrateur n'est pas l'adresse e-mail de votre compte de service (qui se présente sous la forme <nom-projet>-<id>@<nom-projet>.iam.gserviceaccount.com).

Navigateur Chrome

Navigateurs Chrome enregistrés pour la gestion cloud des navigateurs Chrome.

Représentation de la ressource

Le modèle JSON suivant est utilisé pour les ressources du navigateur Chrome dans l'API Directory :

{

"kind": "admin#directory#browserdevice",

"deviceId": string,

"osPlatform": string,

"osPlatformVersion": string,

"osArchitecture":string,

"osVersion": string,

"machineName": string,

"annotatedLocation": string,

"annotatedUser": string,

"annotatedAssetId": string,

"annotatedNotes": string,

"lastPolicyFetchTime": dateTime,

"lastRegistrationTime": dateTime,

"lastActivityTime":dateTime,

"lastStatusReportTime":dateTime,

"virtualDeviceId": string,

"serialNumber": string,

"orgUnitPath": string,

"extensionCount":int,

"policyCount": int,

"safeBrowsingClickThroughCount": int,

"lastDeviceUser": string,

"browserVersions": [string],

"lastDeviceUsers":[

  "userName": string,

  "lastStatusReportTime":dateTime,

  ]

"machinePolicies": [

  "source": string,

  "name": string,

  "value": string,

  "error": string,

  ]

"browsers": [

  "browserVersion": string,

  "channel": string,

  "lastStatusReportTime": dateTime,

  "lastPolicyFetchTime": dateTime,

  "executablePath": string,

  "installedBrowserVersion": string,

  "plugins":[

    "name": string,

    "description": string,

    "fileame" string,

    ]

  "profiles": [

    "name": string,

    "id": string,

    "lastStatusReportTime": dateTime,

    "lastPolicyFectchTime": dateTime,

    "safeBrowsingWarnings": int,

    "safeBrowsingWarningsClickThrough": int,

    "chromeSignedinUserEmail": string,

    "extensionPolicies": [

      "extensionId": string,

      "extensionName": string,

      "policies": [

        "source": string,

        "name": string,

        "value": string,

        "error": string,

      ]

    ]

    "extensions": [

      "extensionId": string,

      "version": string,

      "permissions": [string],

      "name": string,

      "description":string,

      "appType": string,

      "homepageUrl": string,

      "installType": string,

      "configuredAppPolicy": string,

      "disabled": boolean,

      "icons": [

        "size": int,

        "url": string, 

      ]

    ]

    "userPolicies": [

      "source": string,

      "name": string,

      "value": string,

      "error": string,

    ]

    "safeBrowsingWarningsResetTime": string

  ]

}

Appeler l'API 

Récupérer tous les appareils avec navigateur Chrome pour un compte 

Limitation : La valeur nextPageToken renvoyée par la requête de listage a une durée de vie d'une heure. Si votre requête de listage comporte un grand nombre d'appareils avec navigateur Chrome, votre jeton de page peut expirer avant que vous ne puissiez finaliser la création de la liste de tous les appareils. Dans ce cas, vous pouvez appliquer un filtre afin de réduire le nombre d'appareils renvoyés par la requête. En règle générale, le filtrage par UO (unité organisationnelle) est un bon moyen de réduire le nombre de résultats.

 

Pour renvoyer la liste de tous les appareils avec navigateur Chrome associés à un compte, utilisez la requête GET suivante et incluez l'autorisation décrite dans la section Autorisation. Des retours à la ligne ont été inclus dans cet exemple de code pour le rendre plus lisible.

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers?projection={FULL|BASIC}&query={query string}&orderBy={orderBy
category}&sortOrder={ASCENDING|DESCENDING}&pageToken={token for next results
page, if applicable &maxResults=max number of results per page}
  • "customerId" est un identifiant unique du compte Google du client.
  • Pour emprunter l'identité d'un administrateur de compte, vous pouvez également utiliser la chaîne "my_customer", qui représente l'ID client de votre compte. L'opération de récupération d'un utilisateur permet également d'obtenir la valeur "customerId". Utilisez votre adresse e-mail d'administrateur ou la valeur de votre identifiant utilisateur unique d'administrateur dans le paramètre de chemin d'accès userKey de l'opération.

Vous trouverez ci-dessous la liste de tous les paramètres de chaîne de requête pouvant être utilisés dans la requête :

Paramètre Type Description
maxResults entier Nombre maximal de résultats sur une page. La valeur par défaut (maximum) est 100.
orderBy chaîne Propriété d'appareil exécutant le navigateur Chrome à utiliser pour trier les résultats.
    Voici les valeurs acceptées :
    id : ID de l'appareil sur lequel le navigateur Chrome est installé.
    last_sync : date et heure du dernier enregistrement de l'appareil avec navigateur Chrome, de sa dernière synchronisation avec les paramètres des règles ou de l'importation d'un rapport.
    machine_name : nom de la machine associée à l'appareil.
    extension_count : nombre total d'extensions renvoyé pour l'appareil avec navigateur Chrome.
    policy_count : nombre total de règles renvoyé pour l'appareil avec navigateur Chrome.
    os_version : OS de l'appareil sur lequel le navigateur Chrome est installé.
    last_Signed_in_user : dernier utilisateur connecté à l'appareil Chrome.
    noted_user : utilisateur de l'appareil avec navigateur Chrome (annoté par l'administrateur).
    annoted_location : emplacement de l'appareil avec navigateur Chrome (annoté par l'administrateur).
    annotated_asset_id : ID d'élément de l'appareil avec navigateur Chrome (annoté par l'administrateur).
    notes : notes sur l'appareil avec navigateur Chrome (annotées par l'administrateur).
    browser_version_channel : dernière version de Chrome et version renvoyée par l'appareil.
    org_unit : unité organisationnelle dont dépend l'appareil.
    enrollment_date : date d'enregistrement de l'appareil.
    save_browsing_clickthrough : nombre de clics sur les avertissements de navigation sécurisée signalé par cet appareil.
    platform_major_version : type d'OS et version majeure, par exemple Windows 10.
    last_activity : date et heure de la dernière activité de l'appareil.
    browser_version_sortable : plus ancienne version du navigateur installée sur l'appareil.
    os_version_sortable : type d'OS et version complète.
orgUnitPath chaîne Chemin complet de l'unité organisationnelle ou ID unique de l'UO.
groupId chaîne Nom de ressource complet du groupe sous la forme groups/{group} ou ID unique du groupe.
pageToken chaîne Le paramètre de requête pageToken permet de demander la page suivante des résultats de la requête. Le paramètre pageToken de la requête suivante correspond au paramètre nextPageToken de votre réponse précédente.
projection chaîne Limitez les informations renvoyées à un ensemble de champs sélectionnés.
    Les valeurs acceptées sont les suivantes :
    BASIC : comprend uniquement les champs de métadonnées de base (ceux indiqués dans les colonnes de la liste du navigateur de la console d'administration, comme indiqué ci-dessus)
    FULL : inclut tous les champs de métadonnées (comme indiqué ci-dessus)
requête chaîne Recherchez la chaîne à l'aide du langage de requête de page de liste décrit dans la section ci-dessous (langage de requête de filtre).
sortOrder chaîne Détermine si les résultats doivent être renvoyés par ordre croissant ou décroissant. Doit être utilisé avec le paramètre orderBy.
    Les valeurs acceptées sont les suivantes :
    ASCENDING : ordre croissant.
    DESCENDING : ordre décroissant.

Exemple : filtrer les appareils par nom de machine

Le premier exemple recherche un nom de machine spécifique à l'aide de la requête query=machine_name:CLIENT2012. La réponse contient une seule ressource de navigateur Chrome, pour laquelle le nom de machine correspondant à "centre d'assistance".

Requête JSON

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers?projection=BASIC&query=machine_name:CLIENT2012&orderBy=status
&sortOrder=ASCENDING&maxResults=100

Réponse JSON

Une requête réussie affiche le code d'état HTTP 200. Une liste d'appareils avec navigateur correspondant à vos paramètres de requête est également renvoyée :

{
  "kind": "directory#browserdevices",
  "browsers": [
     {
      "deviceId": "device_id_value",
      "kind": "admin#directory#browserdevice",
      "osPlatform": "Windows",
      "osVersion": "6.3.9600.19505",
      "machineName": "CLIENT2012",
      "lastRegistrationTime": "2019-11-04T00:29:17.484Z",
      "lastActivityTime": "2019-11-04T00:29:17.484Z",
      "virtualDeviceId": "virtual_device_id",
      "orgUnitPath": "/Org-unit path",
    },
  ],
  "nextPageToken": "abcdefghijkl123"
}

Récupérer un appareil avec navigateur Chrome

Pour récupérer les propriétés d'un appareil avec navigateur Chrome, utilisez la requête GET suivante et incluez l'autorisation décrite dans "Authorize requests" (Autoriser les requêtes). Des retours à la ligne ont été inclus dans cet exemple de code pour le rendre plus lisible.

GET
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/deviceId?projection={FULL|BASIC}
  • "customerId" est un identifiant unique du compte Google du client.
  • Pour emprunter l'identité d'un administrateur de compte, vous pouvez également utiliser la chaîne "my_customer", qui représente l'ID client de votre compte. L'opération de récupération d'un utilisateur permet également d'obtenir la valeur "customerId". Utilisez votre adresse e-mail d'administrateur ou la valeur de votre identifiant utilisateur unique d'administrateur dans le paramètre de chemin d'accès userKey de l'opération.
  • La valeur deviceId est un identifiant unique pour un appareil. Elle se trouve dans la réponse à l'opération "Récupérer tous les appareils avec navigateur Chrome". Pour en savoir plus sur les chaînes de requête, la requête et les propriétés de réponse, consultez la documentation de référence de l'API.

Vous trouverez ci-dessous la liste de tous les paramètres de chaîne de requête pouvant être utilisés dans la requête :

Paramètre Type Description
deviceId chaîne Identifiant unique de l'appareil. Les ID d'appareil (deviceId) sont renvoyés dans la réponse de la méthode browserdevices.list. Remarque : Ce paramètre est obligatoire.
projection chaîne Détermine si la réponse contient la liste complète des propriétés ou uniquement un sous-ensemble de cette liste.
    Les valeurs acceptées sont les suivantes :
    BASIC : comprend uniquement les champs de métadonnées de base (ceux indiqués dans les colonnes de la liste du navigateur de la console d'administration, comme indiqué ci-dessus)
    FULL : inclut tous les champs de métadonnées (comme indiqué ci-dessus)

Exemple

Requête JSON

Exemple de requête. Des retours à la ligne ont été inclus dans cet exemple de code pour le rendre plus lisible.

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/deviceId?projection=basic

Réponse JSON

Une requête réussie affiche le code d'état HTTP 200. En plus du code d'état, la réponse renvoie les propriétés de l'appareil avec navigateur Chrome :

{
  "deviceId": "device_id_value",
  "kind": "admin#directory#browserdevice",
  "osPlatform": "Windows",
  "osVersion": "6.3.9600.19542",
  "machineName": "CLIENT2012",
  "lastRegistrationTime": "2019-11-27T12:55:27.230Z",
  "lastActivityTime": "2019-11-27T12:55:27.230Z",
  "virtualDeviceId": "virtual_device_id",
  "orgUnitPath": "/Org-unit path",
  "deviceIdentifiersHistory": { 
    "records": [
    { 
      "identifiers": { 
        "machineName": "CLIENT2012", 
        "serialNumber": "ABCD1234567890" }, 
      "firstRecordTime": "2019-11-27T12:55:27.230Z",
      "lastActivityTime": "2019-11-27T12:55:27.230Z"}
  ],
  “has_device_id_collision”: “false”
  }
}

Langage de requête de filtre

 

Lorsque vous utilisez le paramètre "query" dans une requête de liste, chaque terme de la requête doit pouvoir être associé à un appareil avec navigateur spécifique pour être valide. Si vous ne spécifiez aucun opérateur (champ) dans la requête, la recherche trouve un navigateur contenant tous les termes spécifiés dans l'ensemble des champs de texte indexés en interne. Par exemple, si votre requête est "query=machine 73", la réponse retournée correspond à un navigateur associé à la fois au terme "machine" et à la valeur "73" dans tous les champs pouvant être renvoyés sur un appareil avec navigateur, tels que les suivants :

{
  "deviceId": "device_id_value",
  "kind": "admin#directory#browserdevice",
  "osPlatform": "Windows",
  "osVersion": "6.3.9600.19542",
  "machineName": "machine_name",
  "browser_versions": [
    "73.0.0.0",
  ],
  "lastActivityTime": "2019-11-27T12:55:27.230Z",
  "virtualDeviceId": "virtual_device_id",
  "orgUnitPath": "/Org-unit path",
}

 

Remarque 1 : La mise en correspondance s'effectue au niveau des limites de mots (signes de ponctuation ou espaces). Il est donc impossible d'effectuer des correspondances partielles. Dans l'exemple ci-dessus, vous ne pourrez pas effectuer une requête du type query='mach 73'.

Remarque 2 : La mise en correspondance des mots n'est pas sensible à la casse. Par conséquent, une requête sur le mot "machine" recherchera à la fois "Machine" et "machine".

 

Vous pouvez spécifier les champs suivants pour cibler votre recherche sur des champs spécifiques (Remarque : alors que les termes de requête ne sont pas sensibles à la casse, les noms de champs sont quant à eux sensibles à la casse).

Champ Description
machine_name Nom de machine pour l'appareil avec navigateur Chrome.
os_platform Plate-forme d'OS de l'appareil avec navigateur Chrome (par exemple Windows 10).
arch Architecture de processeur de l'appareil avec navigateur Chrome (par exemple, x86_64).
os_version Version du système d'exploitation de l'appareil avec navigateur Chrome (par exemple, 10.0.16299.904).
position Emplacement annoté pour l'appareil avec navigateur Chrome.
user Utilisateur annoté de l'appareil avec navigateur Chrome.
asset_id ID d'élément annoté pour l'appareil avec navigateur Chrome.
note Note annotée pour l'appareil avec navigateur Chrome.
s'inscrire Date et heure d'enregistrement de l'appareil avec navigateur Chrome.
os Combinaison de la plate-forme d'OS et de la version majeure de l'OS pour l'appareil avec navigateur Chrome (par exemple, "Windows 10").
browser_version Version du navigateur Chrome renvoyée pour l'appareil avec navigateur Chrome (par exemple, 73).
enrollment_token Jeton d'enregistrement utilisé pour enregistrer l'appareil avec navigateur Chrome.
report Date et heure du dernier rapport généré pour l'appareil avec navigateur Chrome.
synchroniser Date et heure de la dernière synchronisation des règles pour l'appareil avec navigateur Chrome.
num_extensions Nombre d'extensions renvoyé par l'appareil avec navigateur Chrome.
num_policies Nombre de règles renvoyé par l'appareil avec navigateur Chrome.
machine_user Dernier utilisateur signalé pour l'appareil avec navigateur Chrome.
last_activity 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).
has_device_id_collision Un ID d'appareil est partagé par plusieurs machines identifiées par le navigateur Chrome comme une seule et même machine. Les valeurs acceptées sont true et false.

 

Pour les champs qui acceptent une valeur de temps (register, report, sync, last_activity), le format attendu est AAAA-MM-JJThh:mm:ss (par exemple, 2020-01-01T12:00:00). Vous pouvez également spécifier des plages ouvertes ou fermées pour la date et l'heure :

 

Formulaire

Signification

Exemples

dateheure

à la date/l'heure exacte indiquée

2011-03-23

2011-04-26T14:23:05

dateheure..dateheure

au cours de la période indiquée (début et fin inclus)

2011-03-23..2011-04-26

dateheure..

à la date ou à l'heure indiquée, ou après celle-ci

2011-04-26T14:23:05..

..dateheure

à la date ou à l'heure indiquée, ou avant celle-ci

..2011-04-26T14:23:05
 

Exemples de requêtes de filtre

 

Remarque 1 : Tous les exemples fournis utilisent le paramètre query dans la requête. La valeur du paramètre doit être correctement échappée dans l'URL (échapper les espaces avec des requêtes à plusieurs conditions).

Remarque 2 : Toutes les requêtes peuvent être filtrées sur une unité organisationnelle particulière via l'ajout du paramètre de requête orgUnitPath dans le corps de la requête.

 

  1. Rechercher tous les appareils dont le nom de machine contient un mot :
    1. machine_name:LIX
  2. Rechercher tous les appareils dont le nom de machine contient un mot spécifique et qui ont été enregistrés après une date spécifique :
    1. machine_name:LIX register:​2011-04-26..
  3. ​Rechercher tous les appareils dont le nom de machine contient un mot spécifique et qui ont été enregistrés avant une certaine date : ​
    1. machine_name:LIX register:​..2011-04-26

 

Requêtes non disponibles pour le moment :

  1. Rechercher tous les appareils pour lesquels le nombre d'extensions est inférieur à une certaine valeur (les requêtes de plage pour les valeurs numériques ne sont pas disponibles).
  2. Rechercher tous les appareils dont le nom de machine contient l'un des deux mots possibles (utilisation de l'opérateur OR dans les requêtes).

 

Mettre à jour un appareil avec navigateur Chrome 

Pour mettre à jour les champs annotés d'un appareil avec navigateur Chrome attribué à un compte, utilisez la requête PUT suivante et incluez le jeton d'accès obtenu dans la section "Autorisation". 

PUT
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/{deviceId}
  • "customerId" est un identifiant unique du compte Google du client.
  • Pour emprunter l'identité d'un administrateur de compte, vous pouvez également utiliser la chaîne "my_customer", qui représente l'ID client de votre compte. L'opération de récupération d'un utilisateur permet également d'obtenir la valeur "customerId". Utilisez votre adresse e-mail d'administrateur ou la valeur de votre identifiant utilisateur unique d'administrateur dans le paramètre de chemin d'accès userKey de l'opération.
  • La valeur deviceId est un identifiant unique pour un appareil. Elle se trouve dans la réponse à l'opération "Récupérer tous les appareils avec navigateur Chrome". Pour en savoir plus sur les chaînes de requête, la requête et les propriétés de réponse, consultez la documentation de référence de l'API.

Vous trouverez ci-dessous la liste de tous les paramètres de charge utile pouvant être utilisés dans la requête :

Paramètre Obligatoire Type Description
deviceId obligatoire chaîne Identifiant unique de l'appareil. Les ID d'appareil (deviceId) sont renvoyés dans la réponse de la méthode browserdevices.list. Remarque : Ce paramètre est obligatoire.
annotatedUser facultatif chaîne Utilisateur de l'appareil (annoté par l'administrateur).
annotatedLocation facultatif chaîne

Adresse ou emplacement de l'appareil (annoté par l'administrateur).
annotatedNotes facultatif chaîne Notes concernant cet appareil (annotées par l'administrateur).
annotatedAssetId facultatif chaîne

Identifiant d'élément (annoté par l'administrateur ou spécifié lors de l'enregistrement).

Exemple

Requête JSON

Exemple de requête. Des retours à la ligne ont été inclus dans cet exemple de code pour le rendre plus lisible.

PUT https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value

{

  "deviceId": "device_id_value",
  "annotatedUser": "user 1"
}

Réponse JSON

Une requête réussie affiche le code d'état HTTP 200. En plus du code d'état, la réponse renvoie les propriétés de l'appareil avec navigateur Chrome :

{
  "deviceId": "device_id_value",
  "kind": "admin#directory#browserdevice",
  "osPlatform": "Windows",
  "osVersion": "6.3.9600.19542",
  "machineName": "CLIENT2012",
  "lastRegistrationTime": "2019-11-27T12:55:27.230Z",
  "lastActivityTime": "2019-11-27T12:55:27.230Z",
  "virtualDeviceId": "virtual_device_id",
  "orgUnitPath": "/Org-unit path",
  "annotatedUser": "user 1"
}

 

Supprimer un appareil avec navigateur Chrome 

Pour supprimer un appareil avec navigateur Chrome associé à un compte, utilisez la requête DELETE suivante et incluez le jeton d'accès obtenu en suivant la section "Autorisation". 

DELETE
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices
chromebrowsers/{deviceId}
  • "customerId" est un identifiant unique du compte Google du client.
  • Pour emprunter l'identité d'un administrateur de compte, vous pouvez également utiliser la chaîne "my_customer", qui représente l'ID client de votre compte. L'opération de récupération d'un utilisateur permet également d'obtenir la valeur "customerId". Utilisez votre adresse e-mail d'administrateur ou la valeur de votre identifiant utilisateur unique d'administrateur dans le paramètre de chemin d'accès userKey de l'opération.
  • "deviceId" est l'identifiant unique d'un appareil. Cet ID figure dans la réponse à l'opération "Récupérer tous les appareils Chrome". Pour en savoir plus sur les chaînes de requête, la requête et les propriétés de réponse, consultez la documentation de référence de l'API.

Exemple

Exemple de requête :

DELETE https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value

 

Réponse JSON

Une requête ayant abouti renvoie le code d'état HTTP 200. 

 

Déplacer un appareil avec navigateur Chrome entre des unités organisationnelles 

Pour déplacer des appareils avec navigateur Chrome associés à un compte entre deux unités organisationnelles, utilisez la requête POST ci-dessous et incluez le jeton d'accès obtenu en suivant la section "Autorisation". 

POST
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices/chromebrowsers/moveChromeBrowsersToOu

 

  • "customerId" est un identifiant unique du compte Google du client.
  • Pour emprunter l'identité d'un administrateur de compte, vous pouvez également utiliser la chaîne "my_customer", qui représente l'ID client de votre compte. L'opération de récupération d'un utilisateur permet également d'obtenir la valeur "customerId". Utilisez votre adresse e-mail d'administrateur ou la valeur de votre identifiant utilisateur unique d'administrateur dans le paramètre de chemin d'accès userKey de l'opération.

Vous trouverez ci-dessous la liste de tous les paramètres de charge utile pouvant être utilisés dans la requête :

Paramètre Type Description
resource_ids Liste de chaînes

Liste des ID uniques des appareils avec navigateur Chrome à déplacer. Vous pouvez déplacer jusqu'à 600 navigateurs par requête.
org_unit_path chaîne

Unité organisationnelle de destination vers laquelle déplacer les appareils. Chemin d'accès complet de l'unité organisationnelle ou ID de l'unité (précédé de "id:")

 

Exemple

Exemple de requête.

POST https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/moveChromeBrowsersToOu
{
  "org_unit_path": "/new-path",
  "resource_ids": ["device_id_value_1","device_id_value_2"],
}

Réponse JSON

Une requête ayant abouti renvoie le code d'état HTTP 200. 

Ces informations vous-ont elles été utiles ?

Comment pouvons-nous l'améliorer ?
true
Recherche
Effacer la recherche
Fermer le champ de recherche
Menu principal
2301702185271532900
true
Rechercher dans le centre d'aide
true
true
true
true
true
410864
false
false