Codebeispiele für die Chrome Management Reports API

Auf der Seite Chrome Management Reports API finden Sie eine Übersicht über die API-Funktionen.

In allen unten aufgeführten Anfragen werden die folgenden Variablen verwendet:

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

Anzahl der Chrome-Versionen, die im Datumsbereich aktiv sind

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

Anfrage

  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
}

Anzahl der App-Installationen mit einer bestimmten Anzahl von Berechtigungen

Wenn Sie die Anzahl der Geräte sehen möchten, auf denen eine bestimmte App mit einer bestimmten Anzahl von Berechtigungen installiert ist, verwenden Sie den Wert number_of_permissions im Parameter filter. Sie können die Paginierung der Ergebnisse mit den Parametern pageSize und pageToken steuern.

Weitere Filterparameter finden Sie in der Referenz.

Anfrage

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

Anzahl der Geräte, auf denen eine installierte App installiert ist

Im vorherigen Beispiel wurde eine App gezeigt, die auf zwei Geräten installiert ist. Wenn Sie die Geräte sehen möchten, auf denen diese App installiert ist, können Sie die benutzerdefinierte Methode findInstalledAppDevices verwenden. Sie können die Paginierung der Ergebnisse mit den Parametern pageSize und pageToken steuern.

Anfrage

  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-Browserweitere Informationen zum Gerät abrufen, auf dem die App installiert ist.

Anzahl der Profile, auf denen eine installierte App installiert ist

Wenn Sie die Liste der Profile sehen möchten, auf denen eine App installiert ist, können Sie die benutzerdefinierte Methode findInstalledAppProfiles verwenden. Sie können die Paginierung der Ergebnisse mit den Parametern pageSize und pageToken steuern.

Anfrage

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

Antwort

{
  "totalSize": 2,
  "profiles": [
    {
      "email": "<email1>",
      "profileId": "ca847f92-7988-4ac8-a5a3-d0b8473c8bce",
      "profilePermanentId": "agio5SHt1rlQz3WlnKV41z5Fzxw",
      "profileOrgUnitId": "org_unit_id_1"
    },
    {
      "email": "<email2>",
      "profileId": "g472473e-fe50-4c6e-2ac3-53fe0d0753ce",
      "profilePermanentId": "pgeo2SHt1rlQz1WlnKV41z3Fzxw",
      "profileOrgUnitId": "org_unit_id_2"
    },
  ]
}

Folgeanfrage

Anhand der im vorherigen Beispiel zurückgegebenen permanenten Profil-ID können Sie mit der Chrome Management Profiles APIweitere Informationen zum Profil abrufen, auf dem die App installiert ist.