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_promo_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 بنجاح