Codebeispiele für die Chrome Management Chrome Browsers API

Eine Übersicht über die API-Funktionen finden Sie unter Chrome Management Chrome Browsers API.

Für alle auf dieser Seite gezeigten Anfragen werden die folgenden Variablen verwendet:

  • $TOKEN – OAuth 2.0-Token
  • $CUSTOMER: ID des Kunden oder Literal my_customer

Registrierte Chrome-Browser auflisten

Verwenden Sie den /chromeBrowsers-Endpunkt, um registrierte Chrome-Browser aufzulisten. Sie können die Paginierung mit den Parametern pageSize (maximal und standardmäßig 100) und pageToken steuern. Verwenden Sie orderBy, um die Reihenfolge der Ergebnisse anzugeben. Geben Sie ein filter an, um die Ergebnisse einzugrenzen. Eine Lesemaske kann mit dem Abfrageparameter fields angegeben werden.

Platzhalterabgleich (*) (Präfix prefix*, Suffix *suffix, Teilstring *substring* oder Vorhandensein *) wird mit = und : nur für die Felder machine_name, annotated_asset_id und browser_version unterstützt.

Bei der globalen Textsuche (ohne Angabe eines Feldnamens) wird in allen indexierten Textfeldern gesucht. Wenn mehrere Begriffe durch AND oder Leerzeichen getrennt sind (z. B. filter=machine AND 73 oder filter=machine 73), muss jeder Begriff mit mindestens einem indexierten Textfeld auf dem Browsergerät übereinstimmen (auch über verschiedene Felder hinweg). Wenn Sie mehrere Wörter in einen einzelnen String in Anführungszeichen einschließen (z. B. filter="machine name"), wird in einem einzelnen Feld nach genau dieser zusammenhängenden Wortgruppe gesucht.

Beispiel für Filterabfragen

# 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

Anfrage

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

Antwort

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

Verwalteten Chrome-Browser abrufen

Verwenden Sie den Endpunkt /chromeBrowsers/{browser_permanent_id}, um einen einzelnen registrierten Chrome-Browser abzurufen. Eine Lesemaske kann mit dem Parameter fields angegeben werden.

Anfrage

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

Antwort

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

Anmerkungsinformationen für einen Chrome-Browser aktualisieren

Wenn Sie festgelegte Felder eines registrierten Chrome-Browsers aktualisieren möchten, verwenden Sie den /chromeBrowsers/{browser_permanent_id}-Endpunkt mit der HTTP-Methode PATCH und geben Sie einen updateMask-Abfrageparameter an, der die zu aktualisierenden Felder angibt.

Anfrage

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

Antwort

{
  "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-Browser in eine neue Organisationseinheit verschieben

Wenn Sie verwaltete Chrome-Browser von einer Organisationseinheit in eine andere verschieben möchten, verwenden Sie den /chromeBrowsers:move-Endpunkt. Pro Anfrage können bis zu 600 Browser verschoben werden. Wenn beim Verschieben eines Browsers ein Fehler auftritt, wird keiner der angegebenen Browser verschoben.

Anfrage

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

Antwort

{}

Erfasste Daten aus einem Chrome-Browser löschen

Wenn Sie die Daten löschen möchten, die von einem verwalteten Chrome-Browser erfasst wurden, verwenden Sie den /chromeBrowsers/{browser_permanent_id}-Endpunkt mit HTTP DELETE.

Anfrage

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

Antwort

{}