Chrome Management Chrome Browsers API

تتيح Chrome Management Chrome Browsers API للمشرفين الاطّلاع على البيانات وإدارة متصفّحات Chrome المسجَّلة في Chrome Enterprise Core. يمكن استخدام هذه المجموعة من واجهات برمجة التطبيقات لإدراج متصفّحات Chrome المسجَّلة، واسترداد متصفّح Chrome، وتعديل معلومات التعليقات التوضيحية لمتصفّح Chrome، ونقل متصفّحات Chrome بين الوحدات التنظيمية، وحذف البيانات التي تم جمعها من متصفّح Chrome.

نظرة عامة سريعة على طرق واجهة برمجة التطبيقات

عناوين URL مرتبطة بـ https://chromemanagement.googleapis.com/v1/customers/{customer_id}

الوصف عنوان URL نسبي طريقة HTTP
عرض قائمة بمتصفّحات Chrome المسجَّلة /chromeBrowsers الاطّلاع على
استرداد متصفّح Chrome /chromeBrowsers/{browser_permanent_id} الاطّلاع على
تعديل معلومات التعليقات التوضيحية لمتصفّح Chrome /chromeBrowsers/{browser_permanent_id} PATCH
نقل متصفّحات Chrome إلى وحدة تنظيمية جديدة /chromeBrowsers:move POST
حذف البيانات التي تم جمعها من متصفّح Chrome /chromeBrowsers/{browser_permanent_id} حذف

يمكنك الاطّلاع على عينات التعليمات البرمجية لمعرفة نماذج الطلبات والردود.

جارٍ فلترة النتائج

عند إدراج متصفّحات Chrome باستخدام الطريقة /chromeBrowsers، يمكنك تضييق نطاق النتائج باستخدام مَعلمة طلب البحث filter. يجب أن تكون جميع مَعلمات الفلتر متوافقة مع عناوين URL عند إرسالها في طلبات HTTP. يمكن دمج شروط متعددة باستخدام عامل التشغيل AND.

  • حقول السلسلة والأعداد الصحيحة والتعداد: تتيح استخدام عاملَي المقارنة = و:. يتم استخدام حرف البدل * (البادئة prefix* أو اللاحقة *suffix أو السلسلة الفرعية *substring* أو الوجود *) مع = و: فقط في machine_name وannotated_asset_id وbrowser_version (على سبيل المثال، machine_name=LIX* أو browser_version:"*6367*"). كما يتم استخدام فلترة السلسلة النصية العالمية غير المزخرفة (بدون اسم حقل): يتطابق مصطلح واحد مثل ABC إذا كان أي حقل سلسلة مفهرس يحتوي على ABC، وتتطابق المصطلحات المتعددة التي تم ضمها بواسطة AND أو مسافة بيضاء (على سبيل المثال، machine AND 73 أو machine 73) مع المتصفحات التي تحتوي على كل مصطلح محدد في أي من حقول النص المفهرسة (بينما تتطابق سلسلة واحدة متعددة الكلمات مقتبسة مثل "machine 73" مع العبارة المتجاورة بالضبط داخل حقل واحد).
  • حقول الطوابع الزمنية: تتيح استخدام عوامل المقارنة = و<= و>=. تتطلّب الطوابع الزمنية سلسلة بتنسيق RFC-3339 محاطة بعلامتَي اقتباس مزدوجتَين (على سبيل المثال، "2020-01-01T12:00:00Z" أو "2012-04-21T11:30:00-04:00"). يمكن تحديد نطاقات الطوابع الزمنية المغلقة باستخدام المقارنات.
  • الفلترة حسب الوحدة التنظيمية: يمكنك فلترة المتصفّحات التي تنتمي إلى وحدة تنظيمية معيّنة من خلال تحديد org_unit_path (على سبيل المثال، org_unit_path=/Marketing). تتوفّر ميزة مطابقة الوحدة التنظيمية الواحدة.
  • فلترة المجموعات: يمكنك فلترة المتصفّحات التي تنتمي إلى مجموعة Cloud Identity معيّنة باستخدام الدالة in_group (على سبيل المثال، in_group("groups/00gjdgxs0lm8l7o")).

الحقول القابلة للفلترة

الحقل الوصف
browser_permanent_id المعرّف الفريد الدائم لجهاز متصفِّح Chrome
last_policy_fetch_time يعرض آخر مرة تم فيها استرجاع السياسات في جهاز متصفّح Chrome.
os_platform النظام الأساسي لنظام التشغيل الخاص بالجهاز الذي يعمل عليه متصفّح Chrome (مثل WINDOWS وMAC وLINUX)
os_architecture بنية نظام التشغيل لجهاز متصفّح Chrome
os_version إصدار نظام التشغيل لجهاز متصفّح Chrome.
machine_name اسم الجهاز المرتبط بجهاز متصفّح Chrome
annotated_location تمثّل هذه السمة الموقع الجغرافي الذي تم توضيحه لجهاز متصفِّح Chrome.
annotated_user المستخدم الذي تم توضيحه لجهاز متصفِّح Chrome
annotated_asset_id رقم تعريف مادة العرض الذي تم توضيحه لجهاز متصفِّح Chrome.
annotated_note الملاحظات التي تتضمن تعليقًا توضيحيًّا لجهاز متصفِّح Chrome
org_unit_path مسار الوحدة التنظيمية لجهاز متصفِّح Chrome (مثال: /Marketing)
org_unit_id رقم تعريف الوحدة التنظيمية لجهاز متصفّح Chrome
last_registration_time وقت تسجيل جهاز متصفّح Chrome
os_platform_version النظام الأساسي لنظام التشغيل ورقم الإصدار الرئيسي لجهاز متصفِّح Chrome
browser_version إصدار متصفّح Chrome تم تسجيله في تقرير مثبَّت على الجهاز
last_status_report_time يعرض هذا الحقل آخر وقت تم فيه إعداد تقرير عن حالة جهاز متصفّح Chrome.
extension_count يعرض هذا الحقل عدد الإضافات المثبَّتة على جهاز متصفِّح Chrome.
policy_count عدد السياسات المطبَّقة على جهاز متصفِّح Chrome
last_device_user آخر مستخدم سجّل الدخول على الجهاز
last_activity_time يعرض آخر مرة عرض فيها جهاز متصفّح Chrome نشاطًا (استرجاع السياسات أو إعداد التقارير).
device_id_collision ما إذا كان رقم تعريف الجهاز تتم مشاركته مع عدة أجهزة يتعرّف عليها متصفِّح Chrome على أساس أنّها الجهاز نفسه (true أو false)

دوال الفلترة

الوظيفة الوصف
in_group(string) تتم فلترة قائمة أجهزة متصفّح Chrome لتشمل تلك التي تنتمي إلى اسم مورد مجموعة Cloud Identity المحدّد (التنسيق: in_group("groups/{group_id}")).

ترتيب النتائج

يمكنك تحديد ترتيب النتائج باستخدام مَعلمة طلب البحث orderBy. يتم الترتيب تصاعديًا بشكل تلقائي. لتحديد ترتيب تنازلي لحقل معيّن، أضِف اللاحقة " desc" إلى اسم الحقل (على سبيل المثال، last_activity_time desc).

إذا لم يتم تحديد الترتيب، يكون الترتيب التلقائي هو الترتيب التصاعدي لـ browser_permanent_id.

حقول الترتيب المتوافقة

  • browser_permanent_id
  • last_policy_fetch_time
  • annotated_user
  • annotated_location
  • annotated_asset_id
  • annotated_notes
  • org_unit_path
  • os_version
  • last_registration_time
  • extension_count
  • policy_count
  • last_device_user
  • machine_name
  • browser_version_channel
  • os_platform_version
  • last_activity_time
  • browser_version

امتيازات المشرف

تراعي واجهة برمجة التطبيقات لمتصفّحات Chrome تفويض دور المشرف.

الطريقة امتيازات المشرف المطلوبة
ListChromeBrowsers "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة"
أو "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة -> قراءة"
GetChromeBrowser "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة"
أو "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة -> قراءة"
UpdateChromeBrowser "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة"
MoveChromeBrowsers "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة"
DeleteChromeBrowser "الخدمات -> إدارة Chrome -> الإعدادات -> المتصفّحات المُدارة"

لإدارة أدوار المشرفين وامتيازاتهم، يُرجى الانتقال إلى "وحدة تحكّم المشرف" > "أدوار المشرف".

نطاقات واجهة برمجة التطبيقات

تتطلّب واجهة برمجة التطبيقات Chrome Management Chrome Browsers API نطاقات OAuth التالية:

الطريقة نطاقات OAuth المطلوبة
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
أو https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
أو https://www.googleapis.com/auth/chrome.management.browsers.readonly
UpdateChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
MoveChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
DeleteChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.