Chrome Management App / Extension Details API के लिए कोड के सैंपल

एपीआई की सुविधाओं के बारे में खास जानकारी के लिए, Chrome Management App Details API पर जाएं.

नीचे दिखाए गए सभी अनुरोध में इन वैरिएबल का इस्तेमाल किया गया है:

  • $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} एंडपॉइंट का इस्तेमाल करें. ध्यान दें कि ऐप्लिकेशन आईडी, यूआरएल कोड में बदला गया ऐप्लिकेशन का होम पेज होता है.

अनुरोध

  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 का इस्तेमाल करना होगा. एपीआई का ऐक्सेस पाने के लिए, सेट अप गाइड में दिए गए निर्देशों का पालन करें. इसके बाद, उस एपीआई को कई तरह की कार्रवाइयां करने के लिए अनुरोध भेजा जा सकेगा. ऐप्लिकेशन से जुड़े अनुरोध करने के सैंपल यहां दिए गए हैं. ऐप्लिकेशन का अनुरोध करने पर, की जा सकने वाली सामान्य कार्रवाइयों के उदाहरण यहां दिए गए हैं.

संगठन की किसी इकाई के तहत आने वाले उपयोगकर्ता या डिवाइसों को, मैन्युअल तरीके से इंस्टॉल करने के लिए, एक्सटेंशन के अनुरोध को मंज़ूरी देना

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"

स्वीकार किए गए जवाब को खाली छोड़ा जाना चाहिए:

{}