Method: chromeosdevices.action

استخدِم BatchChangeChromeOsDeviceStatus بدلاً منه. يتخذ إجراءً يؤثر في جهاز يعمل بنظام التشغيل Chrome. ويشمل ذلك إلغاء إذن الوصول إلى الأجهزة وإيقافها وإعادة تفعيلها.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
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

البيانات حول تحديث حالة جهاز يعمل بنظام التشغيل ChromeOS

تمثيل JSON
{
  "action": string,
  "deprovisionReason": string
}
الحقول
action

string

chromeosdevices.action الذي سيتم اتخاذه على الجهاز الذي يعمل بنظام التشغيل Chrome.

القيم المقبولة هي:

  • deprovision: إزالة جهاز من الإدارة لم يعد نشطًا أو جارٍ إعادة بيعه أو يتم إرساله للإرجاع / الإصلاح، استخدِم إجراء إلغاء إذن الوصول لإلغاء ربطه بالإدارة.
  • disable: إذا كنت تعتقد أنّ جهازًا في مؤسستك قد فُقد أو سُرق، يمكنك إيقاف الجهاز حتى لا يتمكّن أي شخص آخر من استخدامه. عند إيقاف جهاز، لن يظهر للمستخدم عند تشغيل جهاز Chrome سوى شاشة تخبره بأنّه تم إيقاف الجهاز وبمعلومات الاتصال المطلوبة بالمكان الذي يمكن إرجاع الجهاز إليه.
  • reenable: يمكنك إعادة تفعيل جهاز سبق إيقافه عند العثور على جهاز مفقود أو استرجاع جهاز مفقود. يمكنك أيضًا استخدام هذه الميزة إذا وضعت علامة على جهاز Chrome بأنّه غير مفعّل عن طريق الخطأ.
  • pre_provisioned_disable: جهاز تم توفيره مسبقًا ولا يمكنه التسجيل. يمكن للمشرف إعادة تفعيل الجهاز للسماح ببرنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" من خلال تغيير الحالة إلى "pre_provisioned_reenable". ملاحظة: من هذه الحالة يمكن إلغاء توفير الجهاز.
  • pre_provisioned_reenable: تم توفير الجهاز بشكلٍ مسبق من قِبل المصنّعين الأصليين للأجهزة. تكون الأجهزة في هذه الحالة مؤهَّلة لبرنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة".
deprovisionReason

string

لا يتم استخدامه إلا عند إيقاف توفير المتطلبات اللازمة لهذا الإجراء. مع إجراء إيقاف توفير المتطلبات اللازمة، يكون هذا الحقل مطلوبًا.

القيم المقبولة هي:

  • different_model_replacement: يُستخدَم هذا الإذن إذا كنت بصدد ترقية جهازك أو استبداله بطراز أحدث من الجهاز نفسه.
  • retiring_device: استخدِم هذا الخيار إذا كنت تعيد بيع الجهاز أو تتبرّع به أو تزيله نهائيًا من الاستخدام.
  • same_model_replacement: استخدِم هذه السمة إذا حدثت مشكلة في جهاز معيّن ويتم استبداله بالطراز نفسه أو بطراز بديل من شركة مصنّعة أو مورِّد إصلاح.
  • upgrade_transfer: استخدِم هذا الخيار عند استبدال الأجهزة المجهزة بخدمة "السحابة الإلكترونية" بأجهزة Chromebook في غضون عام واحد.