واجهة برمجة التطبيقات للدليل: أجهزة Chrome

استرداد جميع أجهزة Chrome لإنشاء حساب

لإرجاع قائمة بجميع أجهزة Chrome التي تم تعيينها لحساب ما، استخدم ما يلي يمكنك طلب GET وتضمين التفويض الموضّح في تفويض الطلبات لتسهيل القراءة، يحتوي نموذج التعليمة البرمجية هذا على إرجاع أسطر:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos?projection={BASIC|FULL}&query=query
&orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING}
&pageToken=token for next results page, if applicable
&maxResults=max number of results per page

  • customerId هو معرّف فريد لحساب العميل على Google.
  • وبصفتك مشرف حساب، يمكنك أيضًا استخدام السلسلة my_customer التي يمثل customerId في حسابك. إليك طريقة أخرى للحصول على customerId هي استخدام زر استرداد مستخدم العملية. استخدِم عنوان البريد الإلكتروني للمشرف أو المستخدم الفريد للمشرف id. في معلمة المسار userKey للعملية.

بالنسبة لسلاسل طلبات البحث وخصائص الطلبات والاستجابة، يمكنك الاطلاع على مرجع واجهة برمجة التطبيقات.

مثال: فلترة الأجهزة حسب المستخدم

يبحث هذا المثال عن مستخدم معيّن باستخدام query=user:help desk. تشير رسالة الأشكال البيانية تحتوي الاستجابة على مورد chromeosdevice واحد، حيث قيمة annotatedUser هي help desk:

طلب JSON

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos?projection=FULL&query=user:help desk&orderBy=status
&sortOrder=ASCENDING&maxResults=100

استجابة JSON

{
  "kind": "directory#chromeosdevices",
  "chromeosdevices": [
     {
       "kind": "directory#chromeosdevice",
       "etag": "1234567890"
       "deviceId": "def456",
       "serialNumber": "234567",
       "status": "ACTIVE",
       "lastSync": "2013-03-05T17:30:04.325Z",
       "supportEndDate": "2014-04-05T17:30:04.325Z",
       "annotatedUser": "help desk",
       "annotatedLocation": "Mountain View help desk Chromebook",
       "annotatedAssetId": "1234567890",
       "notes": "Loaned from support",
       "orderNumber": "1234",
       "willAutoRenew": true,
       "osVersion": "Browser Version 18.0",
       "platformVersion": "Platform Version 1415.2.0",
       "firmwareVersion": "Firmware Version 1.2.3.4",
       "bootMode": "validated",
       "lastEnrollmentTime": "2012-04-05T17:30:04.325Z",
       "orgUnitPath": "corp/engineering",
       "recentUsers": [
         {
           "type": "USER_TYPE_MANAGED",
           "email": "user@customer.com"
         }
       ],
       "activeTimeRanges": [
         {
           "date": "2012-04-05",
           "activeTime": "3600000"
         }
       ],
     }
  ],
  "nextPageToken": "abcdefghijkl123"
}

مثال: فلترة الأجهزة حسب الرقم التسلسلي

يبحث هذا المثال عن رقم تسلسلي معين باستخدام query=id:123456، حيث 123456 هو الرقم التسلسلي للجهاز. يحتوي الرد الموضح أدناه على رد واحد مطابق، حيث السمة serialNumber تطابق قيمة البحث.

طلب JSON

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos?projection=FULL&query=id:123456&orderBy=status
&sortOrder=ASCENDING&maxResults=100

استجابة JSON

{
  "kind": "directory#chromeosdevices",
  "chromeosdevices": [
     {
       "kind": "directory#chromeosdevice",
       "deviceId": "abc123",
       "serialNumber": "123456",
       "status": "SHIPPED",
       "supportEndDate": "1404457200000",
       "model": "model_value",
       "meid": "meid_value",
       "macAddress": "mac_address_value",
       "orderNumber": "1234",
       "willAutoRenew": true
     }
  ],
  "nextPageToken": "abcdefghijkl123"
}

يتضمن مثال الاستجابة هذا model وmeid موقعان (macAddress) إذا كان الجهاز لا يحتوي على هذه الخصائص، فلن يتم تضمينها في الرد. للحصول على التفاصيل الكاملة، يمكنك مراجعة تمثيل موارد أجهزة ChromeOS

تصدير قائمة MEID

يشير meid إلى معرّف الجهاز الجوّال (MEID) لبطاقة الأجهزة الجوّالة التابعة لشبكة الجيل الثالث في جهاز Chrome ويُستخدم MEID عادةً عند إضافة جهاز إلى مشغل شبكة لاسلكية خطة خدمة الدفع عند الاستخدام. لتصدير قائمة MEID، استخدِم طلب GET التالي مع قيم nextPageToken لاسترداد القائمة الكاملة لمعرّفات MEID. لسهولة القراءة، فإن هذا يحتوي نموذج التعليمات البرمجية على إرجاع أسطر:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos?fields=nextPageToken,chromeosdevices(meid)

استرداد جهاز Chrome

لاسترداد خصائص جهاز Chrome، يمكنك استخدام طلب GET التالي مع تضمين التفويض الموضح في تفويض الطلبات لتسهيل القراءة، يحتوي نموذج التعليمة البرمجية هذا على إرجاع أسطر:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • customerId هو معرّف فريد لحساب العميل على Google.
  • وبصفتك مشرف حساب، يمكنك أيضًا استخدام السلسلة my_customer التي يمثل customerId في حسابك. إليك طريقة أخرى للحصول على customerId هي استخدام زر استرداد مستخدم العملية. استخدِم عنوان البريد الإلكتروني للمشرف أو المستخدم الفريد للمشرف id. في معلمة المسار userKey للعملية.
  • deviceId هو معرّف فريد لجهاز ويتم العثور عليه في استجابة عملية استرداد جميع أجهزة Chrome.

بالنسبة لسلاسل طلبات البحث وخصائص الطلبات والاستجابة، يمكنك الاطلاع على مرجع واجهة برمجة التطبيقات.

طلب JSON

مثال على الطلب لتسهيل القراءة، تحتوي عينة التعليمات البرمجية هذه على إرجاع أسطر:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos/deviceId?projection=full

استجابة JSON

يؤدي الطلب الناجح إلى إرجاع رمز حالة HTTP 200. جنبًا إلى جنب مع رمز الحالة، ستعرض الاستجابة خصائص جهاز Chrome:

{
  "kind": "directory#chromeosdevice",
  "deviceId": "device_id_value",
  "serialNumber": "device_serial_number",
  "status": "ACTIVE",
  "lastSync": "2012-04-05T17:30:04.325Z",
  "supportEndDate": "2014-04-05T17:30:04.325Z",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "12345667890",
  "notes": "Loaned from support",
  "orderNumber": "123456",
  "willAutoRenew": true,
  "osVersion": "Browser Version 18.0",
  "platformVersion": "Platform Version 1415.2.0",
  "firmwareVersion": "Firmware Version 1.2.3.4",
  "bootMode": "validated"
  "lastEnrollmentTime": "2012-04-05T17:30:04.325Z",
  "orgUnitPath": "corp/engineering"
}

تحديث جهاز Chrome

لتحديث جهاز Chrome، يمكنك استخدام طلب PUT التالي وتضمين التفويض الموضّح في تفويض الطلبات لتسهيل القراءة، يحتوي نموذج التعليمة البرمجية هذا على إرجاع أسطر:

PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • customerId هو معرّف فريد لحساب العميل على Google.
  • وبصفتك مشرف حساب، يمكنك أيضًا استخدام السلسلة my_customer التي يمثل customerId في حسابك. إليك طريقة أخرى للحصول على customerId هي استخدام زر استرداد مستخدم العملية. استخدِم عنوان البريد الإلكتروني للمشرف أو المستخدم الفريد للمشرف id. في معلمة المسار userKey للعملية.
  • deviceId هو معرّف فريد لجهاز ويتم العثور عليه في استجابة عملية استرداد جميع أجهزة Chrome.

بالنسبة لسلاسل طلبات البحث وخصائص الطلبات والاستجابة، يمكنك الاطلاع على مرجع واجهة برمجة التطبيقات.

طلب JSON

في ما يلي مثال على طلب JSON الذي يعدّل annotatedUser لجهاز Chrome، annotatedLocation وannotatedAssetId وnotes و موقعان (orgUnitPath). لتسهيل القراءة، تحتوي عينة التعليمات البرمجية هذه على إرجاع أسطر:

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/deviceId?projection=full
مثال على نص الطلب:
{
  "deviceId": "device_id_value",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "1234567890",
  "notes": "Loaned from support",
  "orgUnitPath": "/corp/sales"
}

لطلب تعديل، لا تضمِّن سوى المواقع التي تحتوي على قيم معدَّلة في طلبك.

يؤدي الطلب الناجح إلى إرجاع رمز حالة HTTP 200. جنبًا إلى جنب مع رمز الحالة، فستعرض الاستجابة خصائص جهاز Chrome المحدَّث.

إلغاء إذن الوصول إلى أجهزة Chrome أو إيقافها

لإيقاف توفير المتطلبات اللازمة لأجهزة Chrome أو إيقافها، يمكنك استخدام طلب POST التالي. ويجب تضمين التفويض الموضّح في تفويض الطلبات لتسهيل القراءة، يحتوي نموذج التعليمة البرمجية هذا على إرجاع أسطر:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/
devices/chromeos:batchChangeStatus

  • customerId هو معرّف فريد لحساب العميل على Google.
  • وبصفتك مشرف حساب، يمكنك أيضًا استخدام السلسلة my_customer التي يمثل customerId في حسابك. إليك طريقة أخرى للحصول على customerId هي استخدام زر استرداد مستخدم العملية. استخدِم عنوان البريد الإلكتروني للمشرف أو المستخدم الفريد للمشرف id. في معلمة المسار userKey للعملية.

بالنسبة إلى خصائص الطلب والاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.

طلب JSON

يعرض طلب JSON التالي نموذج طلب لإيقاف توفير المتطلبات اللازمة وإيقافه. أجهزة Chrome:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus
نص الطلب لنموذج إيقاف توفير المتطلبات اللازمة هو:
{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
  "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION",
  "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE"
}
نص طلب الإيقاف هو:
  {
    "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
    "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE",
  }

يؤدي الطلب الناجح إلى إرجاع رمز حالة HTTP 200.

نقل أجهزة Chrome إلى الوحدة التنظيمية

لنقل ما يصل إلى 50 جهاز Chrome إلى وحدة تنظيمية، استخدِم ما يلي: يمكنك طلب POST وتضمين التفويض الموضّح في تفويض الطلبات لتسهيل القراءة، يحتوي نموذج التعليمة البرمجية هذا على إرجاع أسطر:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
  • customerId هو معرّف فريد لحساب العميل على Google.
  • وبصفتك مشرف حساب، يمكنك أيضًا استخدام السلسلة my_customer التي يمثل customerId في حسابك. إليك طريقة أخرى للحصول على customerId هي استخدام زر استرداد مستخدم. استخدِم عنوان البريد الإلكتروني للمشرف أو مستخدمًا فريدًا للمشرف قيمة id في معلَمة مسار userKey للعملية.

بالنسبة إلى خصائص الطلب والاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.

طلب JSON

يعرض طلب JSON التالي نموذج طلب لنقل 3 أجهزة Chrome إلى الوحدة التنظيمية المسماة /Marketing:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing

نص طلب نقل الجهاز هو:

{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"]
}

يؤدي الطلب الناجح إلى إرجاع رمز حالة HTTP 200.