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. customerId est également renvoyé dans 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 d'autorisation.

ChromeOsDeviceAction

Données concernant la mise à jour de l'état d'un appareil ChromeOS.

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

string

chromeosdevices.action à effectuer sur l'appareil ChromeOS.

Les valeurs acceptées sont les suivantes :

  • deprovision: pour supprimer un appareil de la gestion qui n'est plus actif, qui est revendu ou qui est envoyé pour être retourné ou réparé, 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 pour qu'il ne puisse plus être utilisé par personne. Lorsqu'un appareil est désactivé, l'utilisateur ne voit qu'un écran lui indiquant qu'il a été désactivé et les coordonnées de l'endroit où il doit le retourner.
  • reenable: réactivez un appareil désactivé lorsqu'un appareil égaré est retrouvé ou qu'un appareil perdu est retourné. 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 configuré. Un administrateur peut réactiver l'appareil pour autoriser l'enregistrement sans contact en définissant son état sur "pre_provisioned_reenable". Remarque: À partir de cet état, l'appareil peut être désabonné.
  • pre_provisioned_reenable: l'appareil est préprovisionné par les OEM. Les appareils dans cet état sont éligibles à l'enregistrement sans contact.
deprovisionReason

string

Utilisé uniquement lorsque l'action est la désactivation. Avec l'action de déprovisionnement, ce champ est obligatoire.

Les valeurs acceptées sont les suivantes :

  • different_model_replacement: utilisez cette option si vous mettez à niveau votre appareil ou si vous le remplacez par un modèle identique plus récent.
  • retiring_device: utilisez cette option si vous revendez, donnez ou mettez au rebut l'appareil.
  • same_model_replacement: à utiliser si un problème matériel est survenu sur un appareil et qu'il est remplacé par le même modèle ou un modèle similaire fourni par un fournisseur / fabricant de réparation.
  • upgrade_transfer: à utiliser si vous remplacez vos appareils Cloud Ready par des Chromebooks d'ici un an.