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

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

تمثيل 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 خلال عام واحد.