Esempi di codice per l'API Chrome Management Reports

Visita l'API Chrome Management Reports per una panoramica delle funzionalità dell'API.

Tutte le richieste mostrate di seguito utilizzano le seguenti variabili:

  • $TOKEN - Token OAuth 2
  • $CUSTOMER: ID del cliente o letterale my_customer
  • $ORG_UNIT_ID: ID di un'unità organizzativa particolare per cui vuoi generare una richiesta.

Numero di versioni di Chrome attive nell'intervallo di date

Per visualizzare quali versioni di Chrome erano attive in un determinato intervallo di tempo: utilizza il valore last_active_date nel parametro filter. Puoi controllare l'impaginazione dei risultati utilizzando i parametri pageSize e pageToken.

Richiesta

  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"

Risposta

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

Conteggia la distribuzione delle installazioni di app con un determinato numero di autorizzazioni

Per visualizzare il numero di dispositivi su cui è stata installata una determinata app con un di autorizzazioni, usa il valore number_of_permissions nella filter. Puoi controllare l'impaginazione dei risultati utilizzando Parametri pageSize e pageToken.

Per altri parametri di filtro, visita la riferimento.

Richiesta

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

Risposta

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

Conteggia i dispositivi su cui è installata un'app

L'esempio precedente mostra un'app che è stata installata su 2 dispositivi. Per visualizzare i dispositivi su cui è stata installata questa app, puoi utilizzare il findInstalledAppDevices metodo personalizzato. Puoi controllare l'impaginazione dei risultati utilizzando pageSize e pageToken parametri.

Richiesta

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

Risposta

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

Richiesta di follow-up

Dato l'ID dispositivo restituito nell'esempio precedente, puoi ottenere più informazioni sul dispositivo su cui è stata installata l'app utilizzando API Admin SDK Directory per i browser Chrome.