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 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 à effectuer sur l'appareil ChromeOS.

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 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 enregistré. 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 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: 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 valeur si vous revendez, donnez ou supprimez définitivement 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.