Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
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.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# Method: chromeosdevices.action\n\n| This item is deprecated!\nUse [BatchChangeChromeOsDeviceStatus](https://developers.google.com/workspace/admin/directory/reference/rest/v1/customer.devices.chromeos/batchChangeStatus) instead. Takes an action that affects a Chrome OS Device. This includes deprovisioning, disabling, and re-enabling devices.\n| **Warning:**\n|\n| \u003cbr /\u003e\n|\n| - Deprovisioning a device will stop device policy syncing and remove device-level printers. After a device is deprovisioned, it must be wiped before it can be re-enrolled.\n| - Lost or stolen devices should use the disable action.\n| - Re-enabling a disabled device will consume a device license. If you do not have sufficient licenses available when completing the re-enable action, you will receive an error. \n| For more information about deprovisioning and disabling devices, visit the [help center](https://support.google.com/chrome/a/answer/3523633).\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). |\n| `resourceId` | `string` The unique ID of the device. The `resourceId`s are returned in the response from the [chromeosdevices.list](https://developers.google.com/workspace/admin/directory/v1/reference/chromeosdevices/list) method. |\n\n### Request body\n\nThe request body contains an instance of [ChromeOsDeviceAction](/workspace/admin/directory/reference/rest/v1/chromeosdevices/action#ChromeOsDeviceAction).\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.device.chromeos`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nChromeOsDeviceAction\n--------------------\n\nData about an update to the status of a Chrome OS device.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ``` { \"action\": string, \"deprovisionReason\": string } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `action` | `string` \u003cbr /\u003e chromeosdevices.action to be taken on the Chrome OS device. Acceptable values are: - `deprovision`: Remove a device from management that is no longer active, being resold, or is being submitted for return / repair, use the deprovision action to dissociate it from management. - `disable`: If you believe a device in your organization has been lost or stolen, you can disable the device so that no one else can use it. When a device is disabled, all the user can see when turning on the Chrome device is a screen telling them that it's been disabled, and your desired contact information of where to return the device.**Note**: Configuration of the message to appear on a disabled device must be completed within the Admin Console. - `reenable`: Re-enable a disabled device when a misplaced device is found or a lost device is returned. You can also use this feature if you accidentally mark a Chrome device as disabled.**Note**: The re-enable action can only be performed on devices marked as disabled. - `pre_provisioned_disable`: A pre-provisioned device that cannot enroll. An admin can re-enable the device to allow Zero-Touch Enrollment by changing the status to \"pre_provisioned_reenable\". **Note**: From this state the device can be deprovisioned. - `pre_provisioned_reenable`: Device is pre-provisioned by OEMs. Devices in this state are eligible for Zero-Touch Enrollment. |\n| `deprovisionReason` | `string` \u003cbr /\u003e Only used when the action is deprovision. With the deprovision action, this field is required. \u003cbr /\u003e | **Note**: The deprovision reason is audited because it might have implications on licenses for perpetual subscription customers. \u003cbr /\u003e Acceptable values are: - `different_model_replacement`: Use if you're upgrading or replacing your device with a newer model of the same device. - `retiring_device`: Use if you're reselling, donating, or permanently removing the device from use. - `same_model_replacement`: Use if a hardware issue was encountered on a device and it is being replaced with the same model or a like-model replacement from a repair vendor / manufacturer. - `upgrade_transfer`: Use if you're replacing your Cloud Ready devices with Chromebooks within one year. |"]]
