Esempi di codice per l'API Chrome Management Reports

Visita la pagina 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: l'ID di una particolare unità organizzativa per la quale vuoi generare una richiesta.

Conteggio delle versioni del profilo Chrome attive nell'intervallo di date

Per visualizzare le versioni del profilo 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:countChromeProfileVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"

Risposta

{
  "profileBrowserVersions": [
    {
      "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": 6
}

Conteggio delle 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
}

Distribuzione del conteggio delle installazioni di app con un numero di autorizzazioni

Per visualizzare il numero di dispositivi che hanno installato una determinata app con un dato 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 altri parametri di filtro, consulta la documentazione di 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 mostrava un'app installata su due 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 che ha installato l'app utilizzando l'API Admin SDK Directory per i browser Chrome.

Conteggio dei profili con un'app installata

Per visualizzare l'elenco dei profili che hanno installato un'app, puoi utilizzare il metodo personalizzato findInstalledAppProfiles. 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:findInstalledAppProfiles?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

Risposta

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

Richiesta di follow-up

Dato l'ID permanente del profilo restituito nell'esempio precedente, puoi ottenere maggiori informazioni sul profilo che ha installato l'app utilizzando l'API Chrome Management Profiles.