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)

اختياريّ. سبب إيقاف توفير المتطلبات اللازمة للجهاز يجب تقديم هذا العنصر إذا تم ضبط "تغييرChromeOsDeviceStatusAction" على "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 بنجاح