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

Conteggia 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
}

Conteggia la distribuzione delle installazioni di app con un numero di 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 la paginazione 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 2 dispositivi. Per visualizzare i dispositivi su cui è installata questa app, puoi utilizzare il metodo personalizzato findInstalledAppDevices. 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: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 i browser Chrome.

Conteggia i profili su cui è installata un'app

Per visualizzare l'elenco dei profili su cui è installata un'app, puoi utilizzare il metodo personalizzato findInstalledAppProfiles. 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: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 ulteriori informazioni sul profilo su cui è installata l'app utilizzando l' API Chrome Management Profiles.