Chrome Management Chrome Browsers API

Chrome Management Chrome Browsers API به سرپرستان اجازه می‌دهد داده‌ها را مشاهده کنند و مرورگرهای Chrome ثبت‌شده در Chrome Enterprise Core را مدیریت کنند. از این مجموعه میاناهای برنامه‌سازی کاربردی می‌توان برای فهرست کردن مرورگرهای Chrome ثبت‌شده، بازیابی مرورگر Chrome، به‌روزرسانی اطلاعات حاشیه‌نویسی برای مرورگر Chrome، انتقال مرورگرهای Chrome بین واحدهای سازمانی، و حذف داده‌های جمع‌آوری‌شده از مرورگر Chrome استفاده کرد.

نمای کلی سریع روش‌های API

نشانی‌های وب مربوط به https://chromemanagement.googleapis.com/v1/customers/{customer_id} است

شرح نشانی وب نسبی روش Http
فهرست کردن مرورگرهای Chrome ثبت‌شده /chromeBrowsers دریافت
بازیابی مرورگر Chrome /chromeBrowsers/{browser_permanent_id} دریافت
به‌روزرسانی اطلاعات حاشیه‌نویسی برای مرورگر Chrome /chromeBrowsers/{browser_permanent_id} وصله
انتقال مرورگرهای Chrome به «واحد سازمانی» (OU) جدید /chromeBrowsers:move POST
حذف داده‌های جمع‌آوری‌شده از مرورگر Chrome /chromeBrowsers/{browser_permanent_id} حذف

برای مشاهده نمونه درخواست‌ها و پاسخ‌ها، نمونه‌های کد را ببینید.

درحال فیلتر کردن نتایج

هنگام فهرست کردن مرورگرهای Chrome با روش /chromeBrowsers می‌توانید نتایج را بااستفاده از پارامتر پُرسمان filter محدود کنید. همه پارامترهای فیلتر باید هنگام ارسال در درخواست‌های HTTP، از URL-escaped استفاده کنند. بااستفاده از اپراتور 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 scopes required
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

برای اطلاعات بیشتر، نمای کلی اصالت‌سنجی را ببینید.