Chrome Management Chrome Browsers API'si için kod örnekleri

API özelliklerine genel bakış için Chrome Management Chrome Browsers API başlıklı makaleyi inceleyin.

Bu sayfada gösterilen tüm isteklerde aşağıdaki değişkenler kullanılır:

  • $TOKEN - OAuth 2.0 jetonu
  • $CUSTOMER - Müşterinin kimliği veya değişmez değer my_customer

Kayıtlı Chrome Tarayıcıları Listeleme

Kayıtlı Chrome tarayıcıları listelemek için /chromeBrowsers uç noktasını kullanın. Sayfalandırmayı pageSize (maksimum ve varsayılan 100) ve pageToken parametrelerini kullanarak kontrol edebilirsiniz. Sonuçların sıralamasını belirtmek için orderBy kullanın. Sonuçları daraltmak için bir filter belirtin. Okuma maskesi, fields sorgu parametresiyle belirtilebilir.

Joker karakter (*) eşleme (önek prefix*, sonek *suffix, alt dize *substring* veya varlık *), yalnızca machine_name, annotated_asset_id ve browser_version alanlarında = ve : ile desteklenir.

Genel metin araması (alan adı belirtilmeden) dizine eklenmiş tüm metin alanlarında arama yapar. Birden fazla terim AND veya boşlukla (örneğin, filter=machine AND 73 veya filter=machine 73) ayrıldığında her terim, tarayıcı cihazdaki en az bir dizine eklenmiş metin alanıyla (farklı alanlarda bile olsa) eşleşmelidir. Birden fazla kelimeyi tek bir tırnaklı dizeye (örneğin, filter="machine name") eklemek, tek bir alan içinde tam olarak bu bitişik kelime öbeğini arar.

Sorguları filtreleme örneği

# Filter by machine name prefix (using ':' or '=')
filter=machine_name:LIX*

# Filter by annotated asset ID suffix
filter=annotated_asset_id="*1001"

# Filter by browser version substring
filter=browser_version:"*6367*"

# Global search across all indexed text fields (matches browsers containing both "machine" and "73" across any fields)
filter=machine AND 73

# Global search with implicit AND (equivalent to `machine AND 73`)
filter=machine 73

# Filter by machine name prefix and registration time range
filter=machine_name:LIX* AND last_registration_time>=2024-01-01T00:00:00Z

# Filter by Organizational Unit path
filter=org_unit_path=/Marketing

İstek

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers?pageSize=2&orderBy=lastActivityTime+desc&filter=os_platform=WINDOWS"

Yanıt

{
  "chromeBrowsers": [
    {
      "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
      "browserPermanentId": "<browserPermanentId1>",
      "machineName": "CLIENT2024-01",
      "osPlatformType": "WINDOWS",
      "osVersion": "10.0.19045",
      "browserVersion": "124.0.6367.60",
      "annotatedUser": "user1@example.com",
      "annotatedLocation": "US-NYC",
      "annotatedAssetId": "ASSET-1001",
      "annotatedNotes": "Engineering workstation",
      "lastActivityTime": "2024-04-23T22:05:44.214362Z",
      "lastPolicySyncTime": "2024-04-23T22:00:00.000Z",
      "lastStatusReportTime": "2024-04-23T22:05:44.214362Z",
      "enrollmentDate": "2024-01-15T10:30:00.000Z",
      "orgUnitPath": "/Engineering",
      "policyCount": 15,
      "extensionCount": 8
    },
    {
      "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId2>",
      "browserPermanentId": "<browserPermanentId2>",
      "machineName": "CLIENT2024-02",
      "osPlatformType": "WINDOWS",
      "osVersion": "11.0.22631",
      "browserVersion": "124.0.6367.60",
      "annotatedUser": "user2@example.com",
      "annotatedLocation": "US-MTV",
      "lastActivityTime": "2024-04-23T21:45:10.102000Z",
      "lastPolicySyncTime": "2024-04-23T21:40:00.000Z",
      "lastStatusReportTime": "2024-04-23T21:45:10.102000Z",
      "enrollmentDate": "2024-02-10T14:15:00.000Z",
      "orgUnitPath": "/Engineering",
      "policyCount": 12,
      "extensionCount": 5
    }
  ],
  "nextPageToken": "<nextPageToken>"
}

Yönetilen Chrome Tarayıcı'yı alma

Kaydedilmiş tek bir Chrome Tarayıcı'yı almak için /chromeBrowsers/{browser_permanent_id} uç noktasını kullanın. Okuma maskesi, fields parametresiyle belirtilebilir.

İstek

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>"

Yanıt

{
  "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
  "browserPermanentId": "<browserPermanentId1>",
  "machineName": "CLIENT2024-01",
  "osPlatformType": "WINDOWS",
  "osVersion": "10.0.19045",
  "browserVersion": "124.0.6367.60",
  "annotatedUser": "user1@example.com",
  "annotatedLocation": "US-NYC",
  "annotatedAssetId": "ASSET-1001",
  "annotatedNotes": "Engineering workstation",
  "lastActivityTime": "2024-04-23T22:05:44.214362Z",
  "lastPolicySyncTime": "2024-04-23T22:00:00.000Z",
  "lastStatusReportTime": "2024-04-23T22:05:44.214362Z",
  "enrollmentDate": "2024-01-15T10:30:00.000Z",
  "orgUnitPath": "/Engineering",
  "policyCount": 15,
  "extensionCount": 8
}

Chrome Tarayıcı için Ek Açıklama Bilgilerini Güncelleme

Kayıtlı bir Chrome tarayıcının ek açıklamalı alanlarını güncellemek için HTTP PATCH yöntemiyle /chromeBrowsers/{browser_permanent_id} uç noktasını kullanın ve güncellenecek alanları belirten bir updateMask sorgu parametresi sağlayın.

İstek

  curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>?updateMask=annotatedUser,annotatedNotes" \
  -d '{
    "annotatedUser": "newuser@example.com",
    "annotatedNotes": "Updated primary workstation"
  }'

Yanıt

{
  "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
  "browserPermanentId": "<browserPermanentId1>",
  "machineName": "CLIENT2024-01",
  "osPlatformType": "WINDOWS",
  "osVersion": "10.0.19045",
  "browserVersion": "124.0.6367.60",
  "annotatedUser": "newuser@example.com",
  "annotatedLocation": "US-NYC",
  "annotatedAssetId": "ASSET-1001",
  "annotatedNotes": "Updated primary workstation",
  "lastActivityTime": "2024-04-23T22:05:44.214362Z",
  "orgUnitPath": "/Engineering"
}

Chrome tarayıcıları yeni bir kuruluş birimine taşıma

Yönetilen Chrome Tarayıcıları bir kuruluş biriminden diğerine taşımak için /chromeBrowsers:move uç noktasını kullanın. İstek başına en fazla 600 tarayıcı taşınabilir. Herhangi bir tarayıcı taşınırken hata oluşursa belirtilen tarayıcıların hiçbiri taşınmaz.

İstek

  curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers:move" \
  -d '{
    "destinationOrgUnitId": "03ph8a2z3v",
    "resourceIds": [
      "customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>",
      "customers/$CUSTOMER/chromeBrowsers/<browserPermanentId2>"
    ]
  }'

Yanıt

{}

Chrome Tarayıcıdan Toplanan Verileri Silme

Yönetilen bir Chrome tarayıcıdan toplanan verileri silmek için HTTP DELETE ile /chromeBrowsers/{browser_permanent_id} uç noktasını kullanın.

İstek

  curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>"

Yanıt

{}