Method: chromeosdevices.action

به جای آن از BatchChangeChromeOsDeviceStatus استفاده کنید. اقدامی را انجام می دهد که بر دستگاه سیستم عامل Chrome تأثیر می گذارد. این شامل حذف، غیرفعال کردن و فعال کردن مجدد دستگاه‌ها می‌شود.

درخواست HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customerId

string

شناسه منحصر به فرد برای حساب Google Workspace مشتری. به‌عنوان مدیر حساب، می‌توانید از نام مستعار my_customer نیز برای نشان دادن customerId حساب خود استفاده کنید. customerId نیز به عنوان بخشی از منبع کاربران بازگردانده می شود.

resourceId

string

شناسه منحصر به فرد دستگاه resourceId ها در پاسخ از روش chromeosdevices.list برگردانده می شوند.

درخواست بدن

بدنه درخواست حاوی نمونه‌ای از ChromeOsDeviceAction است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، پاسخ یک پاسخ HTTP عمومی است که قالب آن با روش تعریف شده است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

ChromeOsDeviceAction

داده‌های مربوط به به‌روزرسانی وضعیت دستگاه 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 تعویض می‌کنید، استفاده کنید.