Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zamiast tego użyj funkcji BatchChangeChromeOsDeviceStatus. Wykonywanie czynności dotyczących urządzenia z ChromeOS. Obejmuje to odprovisionowanie, wyłączenie i ponowne włączenie urządzeń.
Żądanie HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
Unikalny identyfikator konta Google Workspace klienta. Jako administrator konta możesz też użyć aliasu my_customer, aby reprezentować customerId na Twoim koncie. Wartość customerId jest też zwracana w ramach zasobu Users.
resourceId
string
Unikalny identyfikator urządzenia. Parametry resourceId są zwracane w odpowiedzi przez metodę chromeosdevices.list.
deprovision: usuń z zarządzania urządzenie, które nie jest już aktywne, zostało sprzedane lub zostało wysłane do zwrotu lub naprawy. Użyj działania wyrejestrowania, aby odłączyć je od zarządzania.
disable: jeśli uważasz, że urządzenie w Twojej organizacji zostało zgubione lub skradzione, możesz je wyłączyć, aby nikt nie mógł z niego korzystać. Gdy urządzenie z Chrome jest wyłączone, użytkownik widzi tylko ekran z informacją o wyłączeniu i danymi kontaktowymi, pod którymi może zwrócić urządzenie.
reenable: ponowne włączenie wyłączonego urządzenia po znalezieniu lub zwróceniu zgubionego urządzenia. Możesz też użyć tej funkcji, jeśli przypadkowo wyłączysz urządzenie z Chrome.
pre_provisioned_disable: urządzenie przygotowane do obsługi administracyjnej, które nie może się zarejestrować. Administrator może ponownie włączyć urządzenie, aby umożliwić rejestrację typu zero-touch, zmieniając stan na „pre_provisioned_reenable”. Uwaga: w tym stanie urządzenie można wyrejestrować.
pre_provisioned_reenable: urządzenie jest wstępnie skonfigurowane przez producenta. Urządzenia w tym stanie kwalifikują się do rejestracji typu zero-touch.
deprovisionReason
string
Używany tylko wtedy, gdy działaniem jest cofnięcie uprawnień. W przypadku działania anulowania udostępnienia to pole jest wymagane.
Akceptowane wartości:
different_model_replacement: wybierz tę opcję, jeśli wymieniasz urządzenie na nowszy model tego samego typu.
retiring_device: Użyj tej opcji, jeśli sprzedajesz urządzenie, przekazujesz je w ramach darowizny lub wycofujesz z użycia.
same_model_replacement: użyj tego parametru, jeśli wystąpił problem ze sprzętem i urządzenie jest wymieniane na urządzenie tego samego modelu lub na urządzenie podobne do urządzenia od dostawcy lub producenta.
upgrade_transfer: wybierz tę opcję, jeśli w ciągu roku zamierzasz zastąpić urządzenia CloudReady Chromebookami.
[null,null,["Ostatnia aktualizacja: 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. |"]]
