API 機能の概要については、Chrome Management Reports API をご覧ください。
以下に示すリクエストはすべて、次の変数を使用します。
$TOKEN
- OAuth 2 トークン$CUSTOMER
- 顧客の ID またはリテラルmy_customer
$ORG_UNIT_ID
- リクエストを生成する特定の組織部門の ID。
期間中にアクティブな Chrome バージョンをカウントする
特定の期間にアクティブだった Chrome のバージョンを表示するには、filter
パラメータの last_active_date
値を使用します。結果のページ分けは、pageSize
パラメータと pageToken
パラメータを使用して制御できます。
リクエスト
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"
レスポンス
{
"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
}
複数の権限があるアプリのインストールの分布をカウントします
特定の権限で特定のアプリをインストールしたデバイスの数を表示するには、filter
パラメータで number_of_permissions
値を使用します。pageSize
パラメータと pageToken
パラメータを使用すると、結果のページ分けを制御できます。
その他のフィルタ パラメータについては、リファレンスをご覧ください。
リクエスト
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"
レスポンス
{
"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"
]
},
]
}
アプリがインストールされているデバイスをカウントする
上記の例では、アプリが 2 台のデバイスにインストールされていました。このアプリをインストールしたデバイスを表示するには、findInstalledAppDevices
カスタム メソッドを使用します。pageSize
パラメータと pageToken
パラメータを使用すると、結果のページ分けを制御できます。
リクエスト
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppDevices?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"
レスポンス
{
"totalSize": 2,
"devices": [
{
"machine": "MACHINEA-A",
"deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
},
{
"machine": "MACHINE-B",
"deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
}
]
}
フォローアップ リクエスト
Chrome ブラウザ用の Admin SDK Directory API を使用すると、前の例で返されたデバイス ID から、アプリをインストールしたデバイスに関する詳細情報を取得できます。