Contoh Kode untuk Chrome Management Chrome Browsers API

Buka Chrome Management Chrome Browsers API untuk mengetahui ringkasan fitur API.

Semua permintaan yang ditampilkan di halaman ini menggunakan variabel berikut:

  • $TOKEN - Token OAuth 2.0
  • $CUSTOMER - ID pelanggan atau literal my_customer

Mencantumkan Browser Chrome yang Terdaftar

Untuk mencantumkan browser Chrome yang terdaftar, gunakan endpoint /chromeBrowsers. Anda dapat mengontrol penomoran halaman menggunakan parameter pageSize (maksimum dan default 100) dan pageToken. Gunakan orderBy untuk menentukan pengurutan hasil. Tentukan filter untuk mempersempit hasil. Masker baca dapat ditentukan dengan parameter kueri fields.

Pencocokan karakter pengganti (*) (awalan prefix*, akhiran *suffix, substring *substring*, atau kehadiran *) didukung dengan = dan : hanya di kolom machine_name, annotated_asset_id, dan browser_version.

Penelusuran teks global (tanpa menentukan nama kolom) menelusuri semua kolom teks yang diindeks. Jika beberapa istilah dipisahkan oleh AND atau spasi (misalnya, filter=machine AND 73 atau filter=machine 73), setiap istilah harus cocok dengan setidaknya satu kolom teks yang diindeks di perangkat browser (bahkan di seluruh kolom yang berbeda). Menyertakan beberapa kata dalam satu string bertanda kutip (misalnya, filter="machine name") akan menelusuri frasa berurutan persis tersebut dalam satu kolom.

Contoh kueri filter

# 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

Permintaan

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

Respons

{
  "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>"
}

Mengambil Browser Chrome Terkelola

Untuk mengambil satu browser Chrome yang terdaftar, gunakan endpoint /chromeBrowsers/{browser_permanent_id}. Masker baca dapat ditentukan dengan parameter fields.

Permintaan

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

Respons

{
  "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
}

Memperbarui Informasi Anotasi untuk Browser Chrome

Untuk memperbarui kolom yang dianotasi pada browser Chrome yang terdaftar, gunakan endpoint /chromeBrowsers/{browser_permanent_id} dengan metode HTTP PATCH dan berikan parameter kueri updateMask yang menentukan kolom yang akan diperbarui.

Permintaan

  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"
  }'

Respons

{
  "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"
}

Memindahkan Browser Chrome ke Unit Organisasi Baru

Untuk memindahkan browser Chrome terkelola dari satu Unit Organisasi ke Unit Organisasi lain, gunakan endpoint /chromeBrowsers:move. Maksimum 600 browser dapat dipindahkan per permintaan. Jika terjadi error saat memindahkan browser, tidak ada browser yang ditentukan yang akan dipindahkan.

Permintaan

  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>"
    ]
  }'

Respons

{}

Menghapus Data yang Dikumpulkan dari Browser Chrome

Untuk menghapus data yang dikumpulkan dari browser Chrome terkelola, gunakan endpoint /chromeBrowsers/{browser_permanent_id} dengan HTTP DELETE.

Permintaan

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

Tanggapan

{}