Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Вместо этого используйте BatchChangeChromeOsDeviceStatus . Выполняет действие, которое влияет на устройство Chrome OS. Сюда входит деинициализация, отключение и повторное включение устройств.
Отмена инициализации устройства приведет к остановке синхронизации политики устройства и удалению принтеров на уровне устройства. После деинициализации устройства его необходимо очистить, прежде чем его можно будет повторно зарегистрировать.
На потерянных или украденных устройствах следует использовать действие отключения.
Повторное включение отключенного устройства приведет к использованию лицензии на устройство. Если при выполнении действия по повторному включению у вас недостаточно лицензий, вы получите сообщение об ошибке. Дополнительную информацию об деинициализации и отключении устройств можно найти в справочном центре .
HTTP-запрос
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Уникальный идентификатор аккаунта Google Workspace клиента. Как администратор учетной записи вы также можете использовать псевдоним my_customer для представления customerId вашей учетной записи. customerId также возвращается как часть ресурса Users .
resourceId
string
Уникальный идентификатор устройства. resourceId возвращаются в ответе метода chromeosdevices.list .
Данные об обновлении статуса устройства Chrome OS.
JSON-представление
{"action": string,"deprovisionReason": string}
Поля
action
string
chromeosdevices.action, которое необходимо выполнить на устройстве Chrome OS.
Приемлемые значения:
deprovision : удалите из управления устройство, которое больше не активно, перепродается или отправляется на возврат/ремонт; используйте действие деинициализации, чтобы отделить его от управления.
disable : если вы считаете, что устройство в вашей организации было потеряно или украдено, вы можете отключить его, чтобы никто другой не смог его использовать. Когда устройство отключено, все, что пользователь может видеть при включении устройства Chrome, — это экран с сообщением о том, что оно отключено, и желаемую контактную информацию о том, куда вернуть устройство.
reenable : повторное включение отключенного устройства при обнаружении потерянного устройства или возврате потерянного устройства. Вы также можете использовать эту функцию, если случайно пометили устройство Chrome как отключенное.
pre_provisioned_disable : предварительно подготовленное устройство, которое не может зарегистрироваться. Администратор может повторно включить устройство, чтобы разрешить автоматическую регистрацию, изменив статус на «pre_provisioned_reenable». Примечание . В этом состоянии устройство можно деинициализировать.
pre_provisioned_reenable : устройство предварительно подготовлено OEM-производителями. Устройства в этом состоянии имеют право на автоматическую регистрацию.
deprovisionReason
string
Используется только в том случае, если действие — деинициализация. При действии деинициализации это поле является обязательным.
Приемлемые значения:
different_model_replacement : используйте, если вы обновляете или заменяете свое устройство более новой моделью того же устройства.
retiring_device : используйте, если вы перепродаете, жертвуете или навсегда удаляете устройство из использования.
same_model_replacement : используйте, если на устройстве возникла аппаратная проблема и оно заменяется на ту же модель или аналогичную модель от поставщика/производителя ремонта.
upgrade_transfer : используйте, если вы заменяете свои устройства Cloud Ready на Chromebook в течение одного года.
[null,null,["Последнее обновление: 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. |"]]
