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 valore letterale my_customer
• $ORG_UNIT_ID: ID di un'unità organizzativa specifica per cui vuoi generare una richiesta.

Conta le versioni di Chrome attive nell'intervallo di date

Per visualizzare le versioni di Chrome attive in un determinato intervallo di tempo, utilizza il valore last_active_date nel parametro filter. Puoi controllare la paginazione 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
}

Conteggio della distribuzione delle installazioni di app con diverse autorizzazioni

Per visualizzare il numero di dispositivi su cui è installata una determinata app con un determinato numero di autorizzazioni, utilizza il valore number_of_permissions nel parametro filter. Puoi controllare l'impaginazione dei risultati utilizzando i parametri pageSize e pageToken.

Per ulteriori parametri di filtro, consulta il 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"
      ]
    },
  ]
}

Contare 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 è installata questa app, puoi utilizzare il metodo personalizzato findInstalledAppDevices. 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: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 ulteriori informazioni sul dispositivo su cui è installata l'app utilizzando l'API Admin SDK Directory per browser Chrome.