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: استخدِم هذا الخيار إذا كنت تستبدل أجهزة CloudReady بأجهزة Chromebook خلال عام واحد.