استرداد جميع أجهزة 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.