Chrome Management App / Extension Details API のコードサンプル
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
アクセス
Chrome Management App Details API
をご覧ください。
以下に示すすべてのリクエストでは次の変数を使用します。
$TOKEN - OAuth 2 トークン$CUSTOMER - 顧客の ID またはリテラル my_customer
Chrome アプリ / 拡張機能の詳細を取得する
特定の Chrome アプリの詳細を表示するには、
/apps/chrome/{app_id}@{app_version} エンドポイント。
リクエスト
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/apps/chrome/abcdefghijklmnopqrstuvwxyzabcdef@1.2.3"
レスポンス
{
"name": "customers/<customer>/apps/chrome/abcdefghijklmnopqrstuvwxyzabcdef@1.2.3",
"displayName": "Sample Google Chrome Extension",
"description": "A sample Google Chrome extension.",
"revisionId": "1.2.3",
"type": "CHROME",
"iconUri": "https://sample.chrome.extension.google.com/icon.png",
"detailUri": "https://chrome.google.com/webstore/detail/abcdefghijklmnopqrstuvwxyzabcdef",
"firstPublishTime": "2010-10-10T10:10:10.123456Z",
"latestPublishTime": "2020-10-10T10:10:10.123456Z",
"publisher": "sample.com",
"homepageUri": "http://sample.chrome.extension.google.com/home",
"reviewNumber": "10000",
"reviewRating": 4.5,
"chromeAppInfo": {
"supportEnabled": false,
"minUserCount": 6000000,
"permissions": [
{
"type": "content_security_policy",
"documentationUri": "https://developer.chrome.com/extensions/contentSecurityPolicy",
"accessUserData": false
},
{
"type": "contextmenus",
"documentationUri": "https://developer.chrome.com/extensions/contextMenus",
"accessUserData": false
},
],
"siteAccess": [
{
"hostMatch": "<all_urls>"
}
],
"isTheme": false,
"googleOwned": true,
"isCwsHosted": true
}
}
Android アプリの詳細を取得する
特定の Android アプリの詳細を表示するには、次のコマンドを使用します。
/apps/android/{app_id}@{app_version} エンドポイント。
リクエスト
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/apps/android/com.google.android.sample@1.2.3"
レスポンス
{
"name": "customers/<customer>/apps/android/com.google.android.sample@1.2.3",
"displayName": "Sample Android App",
"description": "A sample Android app.",
"appId": "com.google.android.sample",
"revisionId": "1.2.3",
"type": "ANDROID",
"iconUri": "https://sample.android.app.google.com/icon.png",
"detailUri": "https://play.google.com/store/apps/details?id=com.google.android.sample",
"firstPublishTime": "2010-10-10T10:10:10.123456Z",
"latestPublishTime": "2020-10-10T10:10:10.123456Z",
"publisher": "Google LLC",
"isPaidApp": true,
"homepageUri": "http://sample.android.app.google.com/home",
"privacyPolicyUri": "http://sample.android.app.google.com/privacy",
"reviewNumber": "10000",
"reviewRating": 4.5,
"androidAppInfo": {
"permissions": [
{
"type": "android.permission.CAMERA"
},
]
}
}
プログレッシブ ウェブアプリの詳細を確認する
特定の Prgoressive ウェブアプリの詳細を表示するには、次のコマンドを使用します。
/apps/web/{app_id} エンドポイント。
アプリ ID は、URL エンコードされたアプリのホームページです。
リクエスト
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/apps/web/http%3A%2F%2Fsample.web.app.google.com%2F"
レスポンス
{
"name": "customers/<customer>/apps/web/http%3A%2F%sample.web.app.google.com%2F",
"displayName": "sample.web.app.google.com",
"description": "A sample Progressive Web App.",
"appId": "http://sample.web.app.google.com/",
"type": "WEB",
"iconUri": "http://sample.web.app.google.com/icon.png"
}
リクエストされた Chrome 拡張機能を一覧表示する
リクエストされた Chrome アプリを一覧表示するには、
/apps:countChromeAppRequests エンドポイント。
リクエスト
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/apps:countChromeAppRequests"
レスポンス
{
"requestedApps": [
{
"appId": "abcdefghijklmnopqrstuvwxyzabcdef",
"displayName": "Sample Google Chrome Extension",
"appDetails": "customers/<customer>/apps/chrome/abcdefghijklmnopqrstuvwxyzabcdef",
"iconUri": "https://sample.chrome.extension.google.com/icon.png",
"detailUri": "https://chrome.google.com/webstore/detail/abcdefghijklmnopqrstuvwxyzabcdef",
"requestCount": "1",
"latestRequestTime": "2020-10-10T10:10:10.123456Z"
},
],
"totalSize": 1
}
拡張機能のリクエストに対応する
エンドユーザーからのアプリのリクエストに対して適切な対応を取るには、Chrome Policy API を使用する必要があります。設定ガイドに沿って API にアクセスします。これで、その API に対してさまざまなアクションをリクエストできるようになります。アプリ関連のリクエストを作成するサンプルについては、こちらをご覧ください。アプリのリクエストに対して実行できる一般的な操作の例を次に示します。
組織部門内のユーザーまたはデバイスによる拡張機能の手動インストールを承認する
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
requests: [{
policyTargetKey: {
targetResource: "orgunits/04fatzly4jbjho9",
additionalTargetKeys: {"app_id": "chrome:abcdefghijklmnopqrstuvwxyzabcdef"}
},
policyValue: {
policySchema: "chrome.users.apps.InstallType",
value: {appInstallType: "ALLOWED"}
},
updateMask: {paths: "appInstallType"}
}]
}' \
"https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"
正常なレスポンスは空になります。
{}
組織部門内のすべてのユーザー/デバイスに対して期限延長リクエストを拒否する
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
requests: [{
policyTargetKey: {
targetResource: "orgunits/04fatzly4jbjho9",
additionalTargetKeys: {"app_id": "chrome:abcdefghijklmnopqrstuvwxyzabcdef"}
},
policyValue: {
policySchema: "chrome.users.apps.InstallType",
value: {appInstallType: "BLOCKED"}
},
updateMask: {paths: "appInstallType"}
}]
}' \
"https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"
正常なレスポンスは空になります。
{}
組織部門内のすべてのユーザー/デバイスに対して拡張機能を自動インストールする
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
requests: [{
policyTargetKey: {
targetResource: "orgunits/04fatzly4jbjho9",
additionalTargetKeys: {"app_id": "chrome:abcdefghijklmnopqrstuvwxyzabcdef"}
},
policyValue: {
policySchema: "chrome.users.apps.InstallType",
value: {appInstallType: "FORCED"}
},
updateMask: {paths: "appInstallType"}
}]
}' \
"https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"
正常なレスポンスは空になります。
{}
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eThis documentation outlines how to use the Chrome Management APIs to retrieve details for Chrome apps, Android apps, and Progressive Web Apps.\u003c/p\u003e\n"],["\u003cp\u003eYou can fetch app details like name, description, permissions, and publisher information using specific endpoints and an OAuth 2 token.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation also explains how to list requested Chrome extensions and their associated request counts.\u003c/p\u003e\n"],["\u003cp\u003eFinally, it provides guidance on how to use the Chrome Policy API to approve, deny, or force-install extension requests for specific organizational units.\u003c/p\u003e\n"]]],[],null,["# Code Samples for the Chrome Management App / Extension Details API\n\nVisit\n[Chrome Management App Details API](/chrome/management/guides/app_details_api)\nfor an overview of API features.\n\nAll the requests shown below use the following variables:\n\n- `$TOKEN` - OAuth 2 token\n- `$CUSTOMER` - ID of the customer or literal `my_customer`\n\nGet details for a Chrome app / extension\n----------------------------------------\n\nTo view details about a specific Chrome app, use the\n`/apps/chrome/{app_id}@{app_version}` endpoint.\n\n#### Request\n\n curl -X GET \\\n -H \"Authorization: Bearer $TOKEN\" \\\n \"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/apps/chrome/abcdefghijklmnopqrstuvwxyzabcdef@1.2.3\"\n\n#### Response\n\n {\n \"name\": \"customers/\u003ccustomer\u003e/apps/chrome/abcdefghijklmnopqrstuvwxyzabcdef@1.2.3\",\n \"displayName\": \"Sample Google Chrome Extension\",\n \"description\": \"A sample Google Chrome extension.\",\n \"revisionId\": \"1.2.3\",\n \"type\": \"CHROME\",\n \"iconUri\": \"https://sample.chrome.extension.google.com/icon.png\",\n \"detailUri\": \"https://chrome.google.com/webstore/detail/abcdefghijklmnopqrstuvwxyzabcdef\",\n \"firstPublishTime\": \"2010-10-10T10:10:10.123456Z\",\n \"latestPublishTime\": \"2020-10-10T10:10:10.123456Z\",\n \"publisher\": \"sample.com\",\n \"homepageUri\": \"http://sample.chrome.extension.google.com/home\",\n \"reviewNumber\": \"10000\",\n \"reviewRating\": 4.5,\n \"chromeAppInfo\": {\n \"supportEnabled\": false,\n \"minUserCount\": 6000000,\n \"permissions\": [\n {\n \"type\": \"content_security_policy\",\n \"documentationUri\": \"https://developer.chrome.com/extensions/contentSecurityPolicy\",\n \"accessUserData\": false\n },\n {\n \"type\": \"contextmenus\",\n \"documentationUri\": \"https://developer.chrome.com/extensions/contextMenus\",\n \"accessUserData\": false\n },\n ],\n \"siteAccess\": [\n {\n \"hostMatch\": \"\u003call_urls\u003e\"\n }\n ],\n \"isTheme\": false,\n \"googleOwned\": true,\n \"isCwsHosted\": true\n }\n }\n\nGet details for an Android app\n------------------------------\n\nTo view details about a specific Android app, use the\n`/apps/android/{app_id}@{app_version}` endpoint.\n\n#### Request\n\n curl -X GET \\\n -H \"Authorization: Bearer $TOKEN\" \\\n \"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/apps/android/com.google.android.sample@1.2.3\"\n\n#### Response\n\n {\n \"name\": \"customers/\u003ccustomer\u003e/apps/android/com.google.android.sample@1.2.3\",\n \"displayName\": \"Sample Android App\",\n \"description\": \"A sample Android app.\",\n \"appId\": \"com.google.android.sample\",\n \"revisionId\": \"1.2.3\",\n \"type\": \"ANDROID\",\n \"iconUri\": \"https://sample.android.app.google.com/icon.png\",\n \"detailUri\": \"https://play.google.com/store/apps/details?id=com.google.android.sample\",\n \"firstPublishTime\": \"2010-10-10T10:10:10.123456Z\",\n \"latestPublishTime\": \"2020-10-10T10:10:10.123456Z\",\n \"publisher\": \"Google LLC\",\n \"isPaidApp\": true,\n \"homepageUri\": \"http://sample.android.app.google.com/home\",\n \"privacyPolicyUri\": \"http://sample.android.app.google.com/privacy\",\n \"reviewNumber\": \"10000\",\n \"reviewRating\": 4.5,\n \"androidAppInfo\": {\n \"permissions\": [\n {\n \"type\": \"android.permission.CAMERA\"\n },\n ]\n }\n }\n\nGet details for a Progressive Web App\n-------------------------------------\n\nTo view details about a specific Prgoressive Web App, use the\n`/apps/web/{app_id}` endpoint.\nNote that the app id is the URL-encoded app home page.\n\n#### Request\n\n curl -X GET \\\n -H \"Authorization: Bearer $TOKEN\" \\\n \"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/apps/web/http%3A%2F%2Fsample.web.app.google.com%2F\"\n\n#### Response\n\n {\n \"name\": \"customers/\u003ccustomer\u003e/apps/web/http%3A%2F%sample.web.app.google.com%2F\",\n \"displayName\": \"sample.web.app.google.com\",\n \"description\": \"A sample Progressive Web App.\",\n \"appId\": \"http://sample.web.app.google.com/\",\n \"type\": \"WEB\",\n \"iconUri\": \"http://sample.web.app.google.com/icon.png\"\n }\n\nList requested Chrome extensions\n--------------------------------\n\nTo list requested Chrome apps, use the\n`/apps:countChromeAppRequests` endpoint.\n\n#### Request\n\n curl -X GET \\\n -H \"Authorization: Bearer $TOKEN\" \\\n \"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/apps:countChromeAppRequests\"\n\n#### Response\n\n {\n \"requestedApps\": [\n {\n \"appId\": \"abcdefghijklmnopqrstuvwxyzabcdef\",\n \"displayName\": \"Sample Google Chrome Extension\",\n \"appDetails\": \"customers/\u003ccustomer\u003e/apps/chrome/abcdefghijklmnopqrstuvwxyzabcdef\",\n \"iconUri\": \"https://sample.chrome.extension.google.com/icon.png\",\n \"detailUri\": \"https://chrome.google.com/webstore/detail/abcdefghijklmnopqrstuvwxyzabcdef\",\n \"requestCount\": \"1\",\n \"latestRequestTime\": \"2020-10-10T10:10:10.123456Z\"\n },\n ],\n \"totalSize\": 1\n }\n\n### Taking action on extension requests\n\nTo take an appropriate action on app requests from end users, you will need to use the [Chrome Policy API](/chrome/policy). Follow the [setup guide](/chrome/policy/guides/setup) to get access to the API. Then you will be able to make requests to that API to take various actions. Samples for making app related requests can be found [here](/chrome/policy/guides/app_samples_policyapi). The following are examples of common actions you can take on an app request.\n\n#### Approve extension request for manual install by the user/devices under an OU\n\n curl -X POST \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -d '{\n requests: [{\n policyTargetKey: {\n targetResource: \"orgunits/04fatzly4jbjho9\",\n additionalTargetKeys: {\"app_id\": \"chrome:abcdefghijklmnopqrstuvwxyzabcdef\"}\n },\n policyValue: {\n policySchema: \"chrome.users.apps.InstallType\",\n value: {appInstallType: \"ALLOWED\"}\n },\n updateMask: {paths: \"appInstallType\"}\n }]\n }' \\\n \"https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify\"\n\nA successful response should be empty: \n\n {}\n\n#### Deny extension request for all users/devices under an OU\n\n curl -X POST \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -d '{\n requests: [{\n policyTargetKey: {\n targetResource: \"orgunits/04fatzly4jbjho9\",\n additionalTargetKeys: {\"app_id\": \"chrome:abcdefghijklmnopqrstuvwxyzabcdef\"}\n },\n policyValue: {\n policySchema: \"chrome.users.apps.InstallType\",\n value: {appInstallType: \"BLOCKED\"}\n },\n updateMask: {paths: \"appInstallType\"}\n }]\n }' \\\n \"https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify\"\n\nA successful response should be empty: \n\n {}\n\n#### Force install extension for all users/devices under an OU\n\n curl -X POST \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -d '{\n requests: [{\n policyTargetKey: {\n targetResource: \"orgunits/04fatzly4jbjho9\",\n additionalTargetKeys: {\"app_id\": \"chrome:abcdefghijklmnopqrstuvwxyzabcdef\"}\n },\n policyValue: {\n policySchema: \"chrome.users.apps.InstallType\",\n value: {appInstallType: \"FORCED\"}\n },\n updateMask: {paths: \"appInstallType\"}\n }]\n }' \\\n \"https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify\"\n\nA successful response should be empty: \n\n {}"]]
