Chrome Management Chrome Browsers API

Chrome Management Chrome Browsers API memungkinkan administrator melihat data dan mengelola browser Chrome yang terdaftar di Chrome Enterprise Core. Kumpulan API ini dapat digunakan untuk mencantumkan browser Chrome yang terdaftar, mengambil browser Chrome, memperbarui informasi anotasi untuk browser Chrome, memindahkan browser Chrome antar- Unit Organisasi (OU), dan menghapus data yang dikumpulkan dari browser Chrome.

Ringkasan singkat metode API

URL bersifat relatif terhadap https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Deskripsi URL relatif Metode HTTP
Mencantumkan browser Chrome terdaftar /chromeBrowsers DAPATKAN
Mengambil browser Chrome /chromeBrowsers/{browser_permanent_id} DAPATKAN
Memperbarui informasi anotasi untuk browser Chrome /chromeBrowsers/{browser_permanent_id} PATCH
Memindahkan browser Chrome ke Unit Organisasi (OU) baru /chromeBrowsers:move POST
Menghapus data yang dikumpulkan dari browser Chrome /chromeBrowsers/{browser_permanent_id} HAPUS

Lihat contoh kode untuk mengetahui contoh permintaan dan respons.

Memfilter hasil

Saat mencantumkan browser Chrome dengan metode /chromeBrowsers, Anda dapat mempersempit hasil menggunakan parameter kueri filter. Semua parameter filter harus di-escape URL saat dikirim dalam permintaan HTTP. Beberapa kondisi dapat digabungkan menggunakan operator AND.

  • Kolom String, Integer, dan Enum: Mendukung operator perbandingan = dan :. Karakter pengganti * (awalan prefix*, akhiran *suffix, substring *substring*, atau kehadiran *) didukung dengan = dan : hanya untuk machine_name, annotated_asset_id, dan browser_version (misalnya, machine_name=LIX* atau browser_version:"*6367*"). Pemfilteran literal string global tanpa hiasan (tanpa nama kolom) juga didukung: satu istilah seperti ABC cocok jika ada kolom string yang diindeks berisi ABC, dan beberapa istilah yang digabungkan dengan AND atau spasi kosong (misalnya, machine AND 73 atau machine 73) cocok dengan browser yang berisi setiap istilah yang ditentukan di kolom teks yang diindeks (sedangkan string multi-kata yang dikutip tunggal seperti "machine 73" cocok dengan frasa yang berdekatan persis dalam satu kolom).
  • Kolom stempel waktu: Mendukung operator perbandingan =, <=, dan >=. Stempel waktu memerlukan string berformat RFC-3339 yang diapit tanda kutip ganda (misalnya, "2020-01-01T12:00:00Z" atau "2012-04-21T11:30:00-04:00"). Rentang stempel waktu tertutup dapat ditentukan menggunakan perbandingan.
  • Pemfilteran Unit Organisasi: Anda dapat memfilter browser yang termasuk dalam Unit Organisasi tertentu dengan menentukan org_unit_path (misalnya, org_unit_path=/Marketing). Pencocokan Unit Organisasi tunggal didukung.
  • Pemfilteran grup: Anda dapat memfilter browser yang termasuk dalam grup Cloud Identity tertentu menggunakan fungsi in_group (misalnya, in_group("groups/00gjdgxs0lm8l7o")).

Kolom yang dapat difilter

Kolom Deskripsi
browser_permanent_id ID unik permanen perangkat browser Chrome.
last_policy_fetch_time Waktu pengambilan kebijakan terakhir untuk perangkat browser Chrome.
os_platform Platform OS untuk perangkat browser Chrome (misalnya, WINDOWS, MAC, LINUX).
os_architecture Arsitektur OS perangkat browser Chrome.
os_version Versi OS untuk perangkat browser Chrome.
machine_name Nama perangkat yang terkait dengan perangkat browser Chrome.
annotated_location Lokasi yang dianotasi untuk perangkat browser Chrome.
annotated_user Pengguna yang dianotasi untuk perangkat browser Chrome.
annotated_asset_id ID aset yang dianotasi untuk perangkat browser Chrome.
annotated_note Catatan yang dianotasi untuk perangkat browser Chrome.
org_unit_path Jalur Unit Organisasi untuk perangkat browser Chrome (misalnya, /Marketing).
org_unit_id ID Unit Organisasi untuk perangkat browser Chrome.
last_registration_time Waktu pendaftaran untuk perangkat browser Chrome.
os_platform_version Platform OS dan versi utama untuk perangkat browser Chrome.
browser_version Versi browser Chrome yang dilaporkan diinstal di perangkat.
last_status_report_time Waktu laporan status terakhir untuk perangkat browser Chrome.
extension_count Jumlah ekstensi yang diinstal di perangkat browser Chrome.
policy_count Jumlah kebijakan yang diterapkan ke perangkat browser Chrome.
last_device_user Pengguna terakhir yang login di perangkat.
last_activity_time Terakhir kali perangkat browser Chrome menampilkan aktivitas (pengambilan atau pelaporan kebijakan).
device_id_collision Apakah ID perangkat digunakan bersama oleh beberapa perangkat yang diidentifikasi oleh Browser Chrome sebagai perangkat yang sama (true atau false).

Filter fungsi

Fungsi Deskripsi
in_group(string) Memfilter daftar perangkat browser Chrome ke perangkat yang termasuk dalam nama resource grup Cloud Identity yang ditentukan (format: in_group("groups/{group_id}")).

Mengurutkan hasil

Anda dapat menentukan pengurutan hasil menggunakan parameter kueri orderBy. Secara default, pengurutan dilakukan dalam urutan menaik. Untuk menentukan urutan menurun untuk kolom, tambahkan akhiran " desc" ke nama kolom (misalnya, last_activity_time desc).

Jika tidak ditentukan, pengurutan defaultnya adalah urutan menaik dari browser_permanent_id.

Kolom pengurutan yang didukung

  • 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

Hak Istimewa Admin

Chrome Browsers API mematuhi pendelegasian peran administrator.

Metode Hak istimewa admin diperlukan
ListChromeBrowsers "Layanan -> Pengelolaan Chrome -> Setelan -> Browser Terkelola"
atau "Layanan -> Pengelolaan Chrome -> Setelan -> Browser Terkelola -> Baca"
GetChromeBrowser "Layanan -> Pengelolaan Chrome -> Setelan -> Browser Terkelola"
atau "Layanan -> Pengelolaan Chrome -> Setelan -> Browser Terkelola -> Baca"
UpdateChromeBrowser "Layanan -> Pengelolaan Chrome -> Setelan -> Browser Terkelola"
MoveChromeBrowsers "Layanan -> Pengelolaan Chrome -> Setelan -> Browser Terkelola"
DeleteChromeBrowser "Layanan -> Pengelolaan Chrome -> Setelan -> Browser Terkelola"

Untuk mengelola peran dan hak istimewa administrator, buka "Konsol Admin -> Peran Admin".

Cakupan API

Chrome Management Chrome Browsers API memerlukan cakupan OAuth berikut:

Metode Cakupan OAuth yang diperlukan
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
atau https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
atau 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

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.