Exemplos de código para a API Chrome Management Reports

Acesse a API Chrome Management Reports para ter uma visão geral dos recursos da API.

Todas as solicitações mostradas abaixo usam as seguintes variáveis:

• $TOKEN: token OAuth 2
• $CUSTOMER: ID do cliente ou literal my_customer
• $ORG_UNIT_ID: ID de uma unidade organizacional específica para que você quer gerar uma solicitação.

Contar versões do Chrome ativas no período

Para ver quais versões do Chrome estavam ativas em um determinado período, use o valor last_active_date no parâmetro filter. É possível controlar a paginação dos resultados usando os parâmetros pageSize e pageToken.

Solicitação

  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"

Resposta

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

Contagem da distribuição de instalações de apps com várias permissões

Para conferir o número de dispositivos que instalaram um app específico com um determinado número de permissões, use o valor number_of_permissions no parâmetro filter. É possível controlar a paginação dos resultados usando os parâmetros pageSize e pageToken.

Para mais parâmetros de filtro, acesse a referência.

Solicitação

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

Resposta

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

Contar dispositivos que têm um app instalado

O exemplo anterior mostrava um app que foi instalado em dois dispositivos. Para conferir os dispositivos que instalaram esse app, use o método personalizado findInstalledAppDevices. É possível controlar a paginação dos resultados usando os parâmetros pageSize e pageToken.

Solicitação

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

Resposta

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

Solicitação de acompanhamento

Considerando o ID do dispositivo retornado no exemplo anterior, é possível ver mais informações sobre o dispositivo que instalou o app usando a API Admin SDK Directory para navegadores Chrome.