Method: chromeosdevices.action

Utilisez plutôt BatchChangeChromeOsDeviceStatus. Effectue une action qui affecte un appareil Chrome OS. Cela inclut le déprovisionnement, la désactivation et la réactivation des appareils.

Requête HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Identifiant unique du compte Google Workspace du client. En tant qu'administrateur de compte, vous pouvez également utiliser l'alias my_customer pour représenter le customerId de votre compte. Le customerId est également renvoyé dans la ressource "Users".
resourceId

string

Identifiant unique de l'appareil. Les éléments resourceId sont renvoyés dans la réponse par la méthode chromeosdevices.list.

Corps de la requête

Le corps de la requête contient une instance ChromeOsDeviceAction.

Corps de la réponse

Si la requête aboutit, la réponse est une réponse HTTP générique dont le format est défini par la méthode.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

Pour en savoir plus, consultez le guide relatif aux autorisations.

ChromeOsDeviceAction

Données concernant une mise à jour de l'état d'un appareil Chrome OS.

Représentation JSON 
{
  "action": string,
  "deprovisionReason": string
}
Champs
action

string

chromeosdevices.action à effectuer sur l'appareil Chrome OS.

Les valeurs acceptées sont les suivantes :

  • deprovision: supprimez de la gestion un appareil qui n'est plus actif, revendu ou fait l'objet d'un retour ou d'une réparation. Utilisez l'action de déprovisionnement pour le dissocier de la gestion.
  • disable: si vous pensez qu'un appareil de votre organisation a été perdu ou volé, vous pouvez le désactiver afin que personne d'autre ne puisse l'utiliser. Lorsqu'un appareil est désactivé, l'utilisateur ne voit qu'un écran indiquant qu'il a été désactivé, ainsi que les coordonnées souhaitées pour le rendre.
  • reenable: permet de réactiver un appareil désactivé lorsqu'un appareil égaré est retrouvé ou qu'un appareil perdu est renvoyé. Vous pouvez également utiliser cette fonctionnalité si vous avez accidentellement marqué un appareil Chrome comme désactivé.
  • pre_provisioned_disable: appareil préprovisionné qui ne peut pas être enregistré Un administrateur peut réactiver l'appareil afin d'autoriser l'enregistrement sans contact en définissant son état sur "pre_provision_reenable". Remarque: Une fois cet état activé, l'appareil peut être déprovisionné.
  • pre_provisioned_reenable: l'appareil est pré-provisionné par des OEM. Les appareils présentant cet état sont éligibles à l'enregistrement sans contact.
deprovisionReason

string

Utilisé uniquement en cas de déprovisionnement. Avec l'action de déprovisionnement, ce champ est obligatoire.

Les valeurs acceptées sont les suivantes :

  • different_model_replacement: à utiliser si vous mettez à niveau votre appareil ou si vous le remplacez par un modèle plus récent du même appareil.
  • retiring_device: à utiliser si vous revendez, donnez ou mettez fin à l'utilisation de l'appareil.
  • same_model_replacement: à utiliser si un problème matériel a été rencontré sur un appareil et qu'il est remplacé par un modèle de même modèle ou par un appareil de remplacement par un réparateur / fabricant.
  • upgrade_transfer: à utiliser si vous remplacez vos appareils Google Cloud Ready par des Chromebooks sous un an.