Method: customers.chromeBrowsers.list

تسترد هذه الطريقة جميع متصفّحات Chrome الخاصة بعميل (مُقسَّمة إلى صفحات).

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/chromeBrowsers

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
parent

string

الحقل مطلوب. التنسيق: customers/{customerId}

مَعلمات طلب البحث

المعلمات
pageSize

integer

اختيارية: تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. الحد الأقصى والعدد التلقائي هو 100.
pageToken

string

اختيارية: رمز مميّز لتحديد الصفحة التالية في القائمة
filter

string

اختيارية: الفلتر المستخدَم لفلترة المتصفّحات يمكن استخدام الحقول التالية في الفلتر:

  • browser_permanent_id
  • last_policy_fetch_time
  • os_platform
  • os_architecture
  • os_version
  • machine_name
  • annotated_location
  • annotated_user
  • annotated_asset_id
  • annotated_note
  • org_unit_path
  • org_unit_id
  • last_registration_time
  • os_platform_version
  • browser_version
  • last_status_report_time
  • extension_count
  • policy_count
  • last_device_user
  • last_activity_time
  • device_id_collision

يمكن استخدام الدوال التالية في الفلتر:

  • ‫in_group(string): لفلترة المتصفّحات التي تنتمي إلى اسم مورد مجموعة Cloud Identity المحدّد (مثلاً: in_group("groups/{groupId}")).

يمكن استخدام أي من الحقول أو الدوال المذكورة أعلاه لتحديد فلتر، ويمكن الفلترة حسب حقول أو دوال متعددة باستخدام عامل التشغيل AND. تتيح حقول نوع السلسلة وحقول نوع العدد الصحيح وحقول نوع التعداد استخدام عاملَي التشغيل = و:. تتوافق حقول نوع الطابع الزمني مع عوامل التشغيل = و<= و>=. تتطلّب الطوابع الزمنية سلسلة بتنسيق RFC-3339 محاطة بعلامتَي اقتباس مزدوجتَين (مثل "2012-04-21T11:30:00-04:00"). لا يتوافق حرف البدل * إلا مع machine_name وannotated_asset_id وbrowser_version. بالإضافة إلى ذلك، يمكن فلترة السلاسل النصية العامة بدون اسم حقل: يتطابق مصطلح واحد (مثل ABC) إذا كان أي حقل سلسلة نصية مفهرس يحتوي على ABC، وتتطابق المصطلحات المتعددة التي يربطها AND أو مسافة بيضاء (مثل machine AND 73 أو machine 73) مع المتصفحات التي يظهر فيها كل مصطلح في حقل سلسلة نصية مفهرس واحد على الأقل (بينما تتطابق عبارة واحدة بين علامتي اقتباس مثل "machine 73" مع العبارة المتجاورة داخل حقل واحد).
orderBy

string

اختيارية: الحقول المستخدَمة لتحديد ترتيب النتائج الحقول المتوافقة هي:

  • 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

يتم الترتيب تصاعديًا بشكل تلقائي، ولتحديد الترتيب التنازلي لحقل معيّن، يجب إضافة اللاحقة desc إلى اسم الحقل. الترتيب التلقائي هو الترتيب التصاعدي لـ browser_permanent_id.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الاستجابة لطريقة chromeBrowsers.list

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "chromeBrowsers": [
    {
      object (ChromeBrowser)
    }
  ],
  "nextPageToken": string
}
الحقول
chromeBrowsers[]

object (ChromeBrowser)

قائمة بعناصر أجهزة متصفّح Chrome
nextPageToken

string

الرمز المميّز المستخدَم للوصول إلى الصفحة التالية من هذه النتيجة

نطاقات الأذونات

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chrome.management.browsers.readonly
  • https://www.googleapis.com/auth/chrome.management.browsers