Method: customer.devices.chromeos.batchChangeStatus

تعمل هذه السياسة على تغيير حالة مجموعة من أجهزة ChromeOS. لمزيد من المعلومات حول تغيير حالة جهاز ChromeOS: إصلاح أجهزة ChromeOS أو إعادة استخدامها أو إزالتها

طلب HTTP

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

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

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

المَعلمات
customerId

string

مطلوبة. رقم تعريف غير قابل للتغيير لحساب Google Workspace

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
الحقول
deviceIds[]

string

مطلوبة. قائمة بأرقام تعريف أجهزة ChromeOS المطلوب تغييرها الحد الأقصى 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

مطلوبة. تمثّل هذه السمة الإجراء الذي يجب اتخاذه على جهاز ChromeOS لتغيير حالته.
deprovisionReason

enum (DeprovisionReason)

اختياريّ. السبب وراء إيقاف توفير المتطلبات اللازمة للجهاز. يجب تقديم هذه السمة في حال ضبط "changeChromeOsDeviceStatusAction" على "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION". وإلا، احذف هذا الحقل.

نص الاستجابة

استجابة لتغيير حالة مجموعة من أجهزة ChromeOS

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
الحقول
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

النتائج لكل جهاز من أجهزة 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 result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
الحقول
deviceId

string

المعرّف الفريد لجهاز ChromeOS

حقل الاتحاد result

يمكن أن تكون السمة "result" واحدة فقط مما يلي:
error

object (Status)

نتيجة الخطأ للعملية في حال تعذُّرها.
response

object (ChangeChromeOsDeviceStatusSucceeded)

يمكن أن يغيّر الجهاز حالته بنجاح.

الحالة

يحدد النوع Status نموذج خطأ منطقي مناسب لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة التطبيقات RPC. ويتم استخدامه من قِبل gRPC. تحتوي كل رسالة Status على ثلاث أجزاء من البيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.

يمكنك معرفة المزيد حول نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.

تمثيل JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
الحقول
code

integer

رمز الحالة، الذي يجب أن يكون قيمة تعداد google.rpc.Code
message

string

رسالة خطأ موجّهة للمطوّر، ويجب أن تكون باللغة الإنجليزية. يجب ترجمة أي رسالة خطأ تظهر للمستخدمين وإرسالها في حقل google.rpc.Status.details أو ترجمتها من خلال البرنامج.
details[]

object

قائمة بالرسائل التي تتضمن تفاصيل الخطأ. هناك مجموعة شائعة من أنواع الرسائل التي يمكن أن تستخدمها واجهات برمجة التطبيقات.

كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي "@type" على معرّف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }

ChangeChromeOsDeviceStatusSucceeded

لا يحتوي هذا النوع على أي حقول.

الاستجابة لتغيير حالة جهاز ChromeOS بنجاح