با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
به جای آن از BatchChangeChromeOsDeviceStatus استفاده کنید. اقدامی را انجام می دهد که بر دستگاه سیستم عامل Chrome تأثیر می گذارد. این شامل حذف، غیرفعال کردن و فعال کردن مجدد دستگاه‌ها می‌شود.
عدم ارائه یک دستگاه، همگام سازی خط مشی دستگاه را متوقف می کند و چاپگرهای سطح دستگاه را حذف می کند. پس از اینکه دستگاهی از دسترس خارج شد، قبل از ثبت مجدد آن باید پاک شود.
دستگاه های گم شده یا دزدیده شده باید از عمل غیرفعال کردن استفاده کنند.
فعال کردن مجدد یک دستگاه غیرفعال، مجوز دستگاه را مصرف می کند. اگر هنگام انجام فعال کردن مجدد، مجوزهای کافی در دسترس ندارید، یک خطا دریافت خواهید کرد. برای اطلاعات بیشتر در مورد حذف و غیرفعال کردن دستگاه‌ها، به مرکز راهنمایی مراجعه کنید.
درخواست HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
شناسه منحصر به فرد برای حساب Google Workspace مشتری. به‌عنوان مدیر حساب، می‌توانید از نام مستعار my_customer نیز برای نشان دادن customerId حساب خود استفاده کنید. customerId نیز به عنوان بخشی از منبع کاربران بازگردانده می شود.
resourceId
string
شناسه منحصر به فرد دستگاه resourceId ها در پاسخ از روش chromeosdevices.list برگردانده می شوند.
داده‌های مربوط به به‌روزرسانی وضعیت دستگاه Chrome OS.
نمایندگی JSON
{"action": string,"deprovisionReason": string}
فیلدها
action
string
chromeosdevices.action که باید در دستگاه سیستم عامل Chrome انجام شود.
مقادیر قابل قبول عبارتند از:
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 تعویض می‌کنید، استفاده کنید.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
