Codebeispiele für die Chrome Management Reports API

Einen Überblick über die API-Funktionen finden Sie unter Chrome Management Reports API.

Für alle unten aufgeführten Anfragen werden die folgenden Variablen verwendet:

• $TOKEN – OAuth 2-Token
• $CUSTOMER – ID des Kunden oder des Literals my_customer
• $ORG_UNIT_ID: ID einer bestimmten Organisationseinheit, für die Sie eine Anfrage erstellen möchten.

Anzahl der im Zeitraum aktiven Chrome-Versionen

Wenn Sie sehen möchten, welche Chrome-Versionen in einem bestimmten Zeitraum aktiv waren, verwenden Sie den Wert last_active_date im Parameter filter. Mit den Parametern pageSize und pageToken können Sie die Paginierung der Ergebnisse steuern.

Anfragen

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countChromeVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"

Antwort

{
  "browserVersions": [
    {
      "count": "1",
      "version": "85.0.4183.83",
      "system": "SYSTEM_MAC",
      "channel": "STABLE"
    },
    {
      "count": "1",
      "version": "85.0.4183.102",
      "system": "SYSTEM_WINDOWS",
      "channel": "STABLE"
    },
    {
      "count": "13697",
      "version": "71.0.3578.96",
      "system": "SYSTEM_MAC",
      "channel": "STABLE"
    },
    {
      "count": "1",
      "version": "87.0.4280.40",
      "system": "SYSTEM_MAC",
      "channel": "BETA"
    },
    {
      "count": "1",
      "version": "88.0.4314.0",
      "system": "SYSTEM_MAC",
      "channel": "CANARY"
    },
    {
      "count": "1718"
    },
  ],
  "totalSize": 5
}

Verteilung von App-Installationen mit einer Reihe von Berechtigungen zählen

Wenn du die Anzahl der Geräte abrufen möchtest, auf denen eine bestimmte App mit einer bestimmten Anzahl von Berechtigungen installiert ist, verwende den Wert number_of_permissions im Parameter filter. Mit den Parametern pageSize und pageToken lässt sich die Paginierung der Ergebnisse steuern.

Weitere Filterparameter finden Sie in der Referenz.

Anfragen

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"

Antwort

{
  "totalSize": 1,
  "installedApps": [
    {
      "browserDeviceCount": "2",
      "appSource": "CHROME_WEBSTORE",
      "displayName": "Secure Shell App",
      "description": "Terminal emulator and SSH and SFTP client.",
      "appType": "APP",
      "appInstallType": "ADMIN",
      "appId": "pnhechapfaindjhompbnflcldabbghjo",
      "homepageUri": "https://chrome.google.com/webstore/detail/pnhechapfaindjhompbnflcldabbghjo",
      "permissions": [
        "clipboardRead",
        "clipboardWrite",
        "crashReportPrivate",
        "idle",
        "metricsPrivate",
        "notifications",
        "storage",
        "unlimitedStorage"
      ]
    },
  ]
}

Geräte zählen, auf denen eine App installiert ist

Im vorherigen Beispiel wurde eine App auf zwei Geräten installiert. Mit der benutzerdefinierten Methode findInstalledAppDevices können Sie die Geräte aufrufen, auf denen diese App installiert ist. Mit den Parametern pageSize und pageToken können Sie die Paginierung der Ergebnisse steuern.

Anfragen

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppDevices?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

Antwort

{
  "totalSize": 2,
  "devices": [
    {
      "machine": "MACHINEA-A",
      "deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
    },
    {
      "machine": "MACHINE-B",
      "deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
    }
  ]
}

Folgeanfrage

Anhand der im vorherigen Beispiel zurückgegebenen Geräte-ID können Sie mit der Admin SDK Directory API für Chrome-Browser weitere Informationen zum Gerät abrufen, auf dem die App installiert ist.