Acesse a API Chrome Management Reports para conferir 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 a qual você quer gerar uma solicitação.
Contar as versões do perfil do Chrome ativas no período
Para conferir quais versões do perfil do Chrome estavam ativas em um determinado período, use o valor last_active_date no parâmetro filter. Você pode 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:countChromeProfileVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"
Resposta
{
"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
}
Contar as versões do Chrome ativas no período
Para conferir quais versões do Chrome estavam ativas em um determinado período, use o valor last_active_date no parâmetro filter. Você pode 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
}
Contar a distribuição de instalações de apps com um número de 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. Você pode 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 mostrou um app que foi instalado em dois dispositivos.
Para conferir os dispositivos que instalaram esse app, use o método personalizado findInstalledAppDevices.
Você pode 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, você pode receber mais informações sobre o dispositivo que instalou o app usando a API Directory do SDK Admin para navegadores Chrome.
Contar perfis que têm um app instalado
Para conferir a lista de perfis que instalaram um app, use o método personalizado findInstalledAppProfiles.
Você pode 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:findInstalledAppProfiles?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"
Resposta
{
"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"
},
]
}
Solicitação de acompanhamento
Considerando o ID permanente do perfil retornado no exemplo anterior, você pode receber mais informações sobre o perfil que instalou o app usando a API Chrome Management Profiles.