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 literalmy_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.