تعمل هذه السياسة على تغيير حالة مجموعة من أجهزة ChromeOS. لمزيد من المعلومات حول تغيير حالة جهاز ChromeOS: إصلاح أجهزة ChromeOS أو إعادة استخدامها أو إزالتها
طلب HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف غير قابل للتغيير لحساب Google Workspace |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "deviceIds": [ string ], "changeChromeOsDeviceStatusAction": enum ( |
الحقول | |
---|---|
deviceIds[] |
مطلوبة. قائمة بأرقام تعريف أجهزة ChromeOS المطلوب تغييرها الحد الأقصى 50. |
changeChromeOsDeviceStatusAction |
مطلوبة. تمثّل هذه السمة الإجراء الذي يجب اتخاذه على جهاز ChromeOS لتغيير حالته. |
deprovisionReason |
اختياريّ. السبب وراء إيقاف توفير المتطلبات اللازمة للجهاز. يجب تقديم هذه السمة في حال ضبط "changeChromeOsDeviceStatusAction" على "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION". وإلا، احذف هذا الحقل. |
نص الاستجابة
استجابة لتغيير حالة مجموعة من أجهزة ChromeOS
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"changeChromeOsDeviceStatusResults": [
{
object ( |
الحقول | |
---|---|
changeChromeOsDeviceStatusResults[] |
النتائج لكل جهاز من أجهزة ChromeOS المقدَّمة في الطلب. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/admin.directory.device.chromeos
لمزيد من المعلومات، راجِع دليل التفويض.
ChangeChromeOsDeviceStatusAction
الإجراء المطلوب تنفيذه لتغيير حالة جهاز ChromeOS
عمليات التعداد | |
---|---|
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED |
القيمة التلقائية. القيمة غير مستخدَمة. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION |
إيقاف توفير المتطلبات اللازمة لجهاز ChromeOS. إذا كانت لديك أجهزة ChromeOS لم تعُد قيد الاستخدام في مؤسستك، عليك إيقاف توفير المتطلبات اللازمة لها حتى لا تتم إدارتها بعد ذلك. ويؤدي إيقاف توفير المتطلبات اللازمة للجهاز إلى إزالة جميع السياسات التي كانت على الجهاز، وكذلك الطابعات على مستوى الجهاز، وإمكانية استخدام الجهاز كتطبيق kiosk. بناءً على الترقية المرتبطة بالجهاز، قد يؤدي هذا الإجراء إلى إعادة الترخيص إلى مجموعة التراخيص، ما يسمح لك باستخدام الترخيص على جهاز مختلف. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE |
لإيقاف جهاز ChromeOS. يمكنك استخدام هذا الإجراء إذا فقد مستخدم جهازه أو سُرِق، لأنّ ذلك يجعل الجهاز لا يزال مُدارًا ومن ثم بإمكانه تطبيق السياسات، ولكن لا يمكن لأحد استخدامه. بناءً على الترقية المرتبطة بالجهاز، قد يؤدي هذا الإجراء إلى إعادة الترخيص إلى مجموعة التراخيص، ما يسمح لك باستخدام الترخيص على جهاز مختلف. |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE |
تتيح هذه السياسة إعادة تفعيل جهاز ChromeOS لاستخدامه بعد إيقافه. يعيد تفعيل الجهاز بعد عدم فقدانه أو استرداده. يسمح هذا الإجراء باستخدام الجهاز مرة أخرى. بناءً على الترقية المرتبطة بالجهاز، قد يستهلك هذا الإجراء ترخيصًا واحدًا من مجموعة التراخيص، ما يعني أنّه في حال عدم توفّر تراخيص كافية، ستتعذّر العملية. |
ChangeChromeOsDeviceStatusResult
نتيجة لجهاز ChromeOS واحد لعملية تغيير الحالة.
تمثيل JSON |
---|
{ "deviceId": string, // Union field |
الحقول | |
---|---|
deviceId |
المعرّف الفريد لجهاز ChromeOS |
حقل الاتحاد يمكن أن تكون السمة " |
|
error |
نتيجة الخطأ للعملية في حال تعذُّرها. |
response |
يمكن أن يغيّر الجهاز حالته بنجاح. |
الحالة
يحدد النوع Status
نموذج خطأ منطقي مناسب لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة التطبيقات RPC. ويتم استخدامه من قِبل gRPC. تحتوي كل رسالة Status
على ثلاث أجزاء من البيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.
يمكنك معرفة المزيد حول نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.
تمثيل JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
الحقول | |
---|---|
code |
رمز الحالة، الذي يجب أن يكون قيمة تعداد |
message |
رسالة خطأ موجّهة للمطوّر، ويجب أن تكون باللغة الإنجليزية. يجب ترجمة أي رسالة خطأ تظهر للمستخدمين وإرسالها في حقل |
details[] |
قائمة بالرسائل التي تتضمن تفاصيل الخطأ. هناك مجموعة شائعة من أنواع الرسائل التي يمكن أن تستخدمها واجهات برمجة التطبيقات. كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
ChangeChromeOsDeviceStatusSucceeded
لا يحتوي هذا النوع على أي حقول.
الاستجابة لتغيير حالة جهاز ChromeOS بنجاح