Method: customers.chromeBrowsers.list

همه مرورگرهای Chrome مشتری را بازیابی می‌کند (صفحه‌بندی‌شده).

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
parent

string

الزامی. قالب: customers/{customerId}

پارامترهای پُرسمان

پارامترها
pageSize

integer

اختیاری. حداکثر تعداد نتایج برای برگرداندن. حداکثر و پیش‌فرض ۱۰۰ است.
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