نمونه کد برای برنامه مدیریت Chrome / API جزئیات برنامه افزودنی
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
برای مروری بر ویژگیهای API ، از API جزئیات برنامه مدیریت Chrome دیدن کنید.
تمام درخواست های نشان داده شده در زیر از متغیرهای زیر استفاده می کنند:
-
$TOKEN
- نشانه OAuth 2 -
$CUSTOMER
- شناسه مشتری یا به معنای واقعی کلمه 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}
استفاده کنید. توجه داشته باشید که شناسه برنامه، صفحه اصلی برنامه رمزگذاری شده با 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 درخواستی، از /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 درخواست دهید. نمونه هایی برای ایجاد درخواست های مرتبط با برنامه را می توانید در اینجا پیدا کنید. موارد زیر نمونههایی از اقدامات رایجی است که میتوانید در درخواست برنامه انجام دهید.
درخواست برنامه افزودنی را برای نصب دستی توسط کاربر/دستگاههای تحت یک OU تأیید کنید
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"
یک پاسخ موفق باید خالی باشد:
{}
درخواست برنامه افزودنی را برای همه کاربران/دستگاههای تحت یک OU رد کنید
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"
یک پاسخ موفق باید خالی باشد:
{}
نصب اجباری برنامه افزودنی برای همه کاربران/دستگاههای تحت یک OU
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"
یک پاسخ موفق باید خالی باشد:
{}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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 بهوقت ساعت هماهنگ جهانی."],[[["\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 {}"]]