Method: chromeosdevices.action

Utilisez BatchChangeChromeOsDeviceStatus à la place. Effectue une action qui affecte un appareil Chrome OS. Cela inclut le déprovisionnement, la désactivation et la réactivation d'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 customerId de votre compte. Le customerId est également renvoyé dans le cadre de la ressource Users.
resourceId

string

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

Corps de la requête

Le corps de la requête contient une instance de 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 la mise à jour de l'état d'un appareil Chrome OS.

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

string

chromeosdevices.action sur l'appareil Chrome OS.

Les valeurs acceptées sont les suivantes :

  • deprovision: supprimez de la gestion un appareil qui n'est plus actif, qui est en cours de revente, ou qui est en cours de retour ou de 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 Chrome est désactivé, tout ce que l'utilisateur peut voir lorsqu'il s'allume est un écran l'informant qu'il a été désactivé, ainsi que les coordonnées souhaitées indiquant où retourner l'appareil.
  • reenable: réactiver un appareil désactivé lorsqu'un appareil égaré est retrouvé ou égaré. 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 pour autoriser l'enregistrement sans contact en remplaçant son état par "pre_provisioned_reenable". Remarque: L'appareil peut alors être déprovisionné.
  • pre_provisioned_reenable: l'appareil est pré-provisionné par les OEM. Les appareils dans cet état peuvent bénéficier de l'enregistrement sans contact.
deprovisionReason

string

Utilisé uniquement en cas de déprovisionnement. Ce champ est obligatoire avec l'action de déprovisionnement.

Les valeurs acceptées sont les suivantes :

  • different_model_replacement: utilisez cette option si vous remplacez votre appareil par un modèle plus récent du même appareil.
  • retiring_device: utilisez cette valeur si vous revendez, donnez ou supprimez définitivement l'appareil.
  • same_model_replacement: à utiliser si un problème matériel a été rencontré sur un appareil et qu'il est remplacé par le même modèle ou par un modèle de remplacement similaire auprès d'un prestataire / fabricant de réparation.
  • upgrade_transfer: utilisez cette option si vous remplacez vos appareils connectés au cloud par des Chromebooks dans un délai d'un an.