Chrome Management Chrome Browsers API

Chrome Management Chrome Browsers API, yöneticilerin verileri görüntülemesine ve Chrome Enterprise Core'a kayıtlı Chrome Tarayıcıları yönetmesine olanak tanır. Bu API grubu, kayıtlı Chrome tarayıcıları listelemek, bir Chrome tarayıcıyı almak, bir Chrome tarayıcının ek açıklama bilgilerini güncellemek, Chrome tarayıcıları kuruluş birimleri arasında taşımak ve bir Chrome tarayıcıdan toplanan verileri silmek için kullanılabilir.

API yöntemlerine ilişkin özet bilgiler

URL'ler https://chromemanagement.googleapis.com/v1/customers/{customer_id} ile ilgilidir.

Açıklama Göreli URL HTTP yöntemi
Kayıtlı Chrome Tarayıcıları listeleme /chromeBrowsers YouTube'daki
Chrome Tarayıcı'yı alma /chromeBrowsers/{browser_permanent_id} YouTube'daki
Chrome Tarayıcı için ek açıklama bilgilerini güncelleme /chromeBrowsers/{browser_permanent_id} YAMA
Chrome Tarayıcıları yeni bir kuruluş birimine taşıma /chromeBrowsers:move POST
Chrome Tarayıcı'dan toplanan verileri silme /chromeBrowsers/{browser_permanent_id} SİL

Örnek istekler ve yanıtlar için kod örneklerine bakın.

Sonuçlar filtreleniyor

/chromeBrowsers yöntemiyle Chrome tarayıcıları listelerken filter sorgu parametresini kullanarak sonuçları daraltabilirsiniz. Tüm filtre parametreleri, HTTP isteklerinde gönderilirken URL kod dışına alınmalıdır. Birden fazla koşul, AND operatörü kullanılarak birleştirilebilir.

  • Dize, tam sayı ve enum alanları: = ve : karşılaştırma operatörlerini destekler. Joker karakter * (önek prefix*, sonek *suffix, alt dize *substring* veya varlık *), yalnızca machine_name, annotated_asset_id ve browser_version için = ve : ile desteklenir (örneğin, machine_name=LIX* veya browser_version:"*6367*"). Süslemesiz global dize değişmezi filtreleme (alan adı olmadan) de desteklenir: ABC gibi tek bir terim, dizine eklenmiş herhangi bir dize alanı ABC içeriyorsa eşleşir ve AND veya boşlukla birleştirilen birden fazla terim (örneğin, machine AND 73 veya machine 73), dizine eklenmiş metin alanlarından herhangi birinde belirtilen her terimi içeren tarayıcılarla eşleşir ("machine 73" gibi tek tırnaklı çok kelimeli bir dize ise tek bir alandaki tam bitişik ifadeyle eşleşir).
  • Zaman damgası alanları: =, <= ve >= karşılaştırma operatörlerini destekler. Zaman damgaları, çift tırnak içine alınmış RFC-3339 biçimli bir dize (ör. "2020-01-01T12:00:00Z" veya "2012-04-21T11:30:00-04:00") bekler. Kapalı zaman damgası aralıkları, karşılaştırmalar kullanılarak belirtilebilir.
  • Kuruluş birimine göre filtreleme: org_unit_path (ör. org_unit_path=/Marketing) değerini belirterek belirli bir kuruluş birimine ait tarayıcıları filtreleyebilirsiniz. Tek bir kuruluş birimiyle eşleştirme desteklenir.
  • Grup filtreleme: in_group işlevini kullanarak belirli bir Cloud Identity grubuna ait tarayıcıları filtreleyebilirsiniz (ör. in_group("groups/00gjdgxs0lm8l7o")).

Filtrelenebilir alanlar

Alan Açıklama
browser_permanent_id Chrome Tarayıcı cihazının kalıcı benzersiz tanımlayıcısı.
last_policy_fetch_time Chrome Tarayıcı cihazının son politika getirme zamanı.
os_platform Chrome Tarayıcı cihazının işletim sistemi platformu (ör. WINDOWS, MAC, LINUX).
os_architecture Chrome Tarayıcı cihazının OS mimarisi.
os_version Chrome Tarayıcı cihazının OS sürümü.
machine_name Chrome Tarayıcı cihazıyla ilişkili makinenin adı.
annotated_location Chrome Tarayıcı cihazının belirtilen konumu.
annotated_user Chrome Tarayıcı cihazı için belirtilen kullanıcı.
annotated_asset_id Chrome Tarayıcı cihazının belirtilen öğe kimliği.
annotated_note Chrome Tarayıcı cihazının belirtilen notları.
org_unit_path Chrome Tarayıcı cihazının kuruluş birimi yolu (ör. /Marketing).
org_unit_id Chrome Tarayıcı cihazının kuruluş birimi kimliği.
last_registration_time Chrome Tarayıcı cihazının kayıt zamanı.
os_platform_version Chrome Tarayıcı cihazının OS platformu ve ana sürümü.
browser_version Cihazda yüklü olduğu bildirilen Chrome Tarayıcı sürümü.
last_status_report_time Chrome Tarayıcı cihazının son durum raporu zamanı.
extension_count Chrome Tarayıcı cihazına yüklenen uzantıların sayısı.
policy_count Chrome Tarayıcı cihazına uygulanan politika sayısı.
last_device_user Makinede en son oturum açan kullanıcı.
last_activity_time Chrome Tarayıcı cihazının en son etkinlik (politika getirme veya raporlama) gösterdiği zaman.
device_id_collision Cihaz kimliğinin, Chrome Tarayıcı'nın aynı makine olarak tanımladığı birden fazla makine tarafından paylaşılıp paylaşılmadığı (true veya false).

İşlevleri filtrele

İşlev Açıklama
in_group(string) Chrome Tarayıcı cihazlarının listesini, belirtilen Cloud Identity grubu kaynak adına (biçim: in_group("groups/{group_id}")) ait olanlarla filtreler.

Sonuçları sıralama

orderBy sorgu parametresini kullanarak sonuçların sıralamasını belirtebilirsiniz. Varsayılan olarak, sıralama artan düzendedir. Bir alan için azalan sıralama belirtmek istiyorsanız alan adına " desc" son ekini ekleyin (ör. last_activity_time desc).

Belirtilmezse varsayılan sıralama browser_permanent_id değerine göre artan düzendedir.

Desteklenen sıralama alanları

  • 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

Yönetici Ayrıcalıkları

Chrome Tarayıcılar API'si, yönetici rolü yetkilendirmesine uyar.

Yöntem Yönetici ayrıcalıkları gereklidir
ListChromeBrowsers "Hizmetler -> Chrome Yönetimi -> Ayarlar -> Yönetilen Tarayıcılar"
veya "Hizmetler -> Chrome Yönetimi -> Ayarlar -> Yönetilen Tarayıcılar -> Okuma"
GetChromeBrowser "Hizmetler -> Chrome Yönetimi -> Ayarlar -> Yönetilen Tarayıcılar"
veya "Hizmetler -> Chrome Yönetimi -> Ayarlar -> Yönetilen Tarayıcılar -> Okuma"
UpdateChromeBrowser "Hizmetler -> Chrome Yönetimi -> Ayarlar -> Yönetilen Tarayıcılar"
MoveChromeBrowsers "Hizmetler -> Chrome Yönetimi -> Ayarlar -> Yönetilen Tarayıcılar"
DeleteChromeBrowser "Hizmetler -> Chrome Yönetimi -> Ayarlar -> Yönetilen Tarayıcılar"

Yönetici rollerini ve ayrıcalıklarını yönetmek için "Yönetici Konsolu -> Yönetici Rolleri"ne gidin.

API kapsamları

Chrome Management Chrome Browsers API, aşağıdaki OAuth kapsamlarını gerektirir:

Yöntem OAuth kapsamları gerekli
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
veya https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
veya 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

Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış başlıklı makaleyi inceleyin.