Method: chromeosdevices.action

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

طلب 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

بيانات عن تعديل في حالة جهاز Chrome OS

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

string

chromeosdevices.action التي يجب اتخاذها على جهاز ChromeOS

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

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

string

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

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

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