Chrome मैनेजमेंट रिपोर्ट एपीआई के लिए कोड सैंपल

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

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

  • $TOKEN - OAuth 2 टोकन
  • $CUSTOMER - ग्राहक का आईडी या लिटरल my_customer
  • $ORG_UNIT_ID - किसी खास संगठन यूनिट का आईडी, जिसके लिए आपको अनुरोध जनरेट करना है.

तय की गई तारीख की सीमा में, Chrome प्रोफ़ाइल के चालू वर्शन की संख्या

यह देखने के लिए कि तय की गई तारीख की सीमा में, Chrome प्रोफ़ाइल के कौनसे वर्शन चालू थे, filter पैरामीटर में last_active_date वैल्यू का इस्तेमाल करें. pageSize और pageToken पैरामीटर का इस्तेमाल करके, नतीजों के पेज नंबर तय किए जा सकते हैं.

अनुरोध

  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"

जवाब

{
  "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
}

तय की गई तारीख की सीमा में, 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"
      ]
    },
  ]
}

ऐसे डिवाइसों की संख्या जिनमें कोई इंस्टॉल किया गया ऐप्लिकेशन है

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

ऐसी प्रोफ़ाइलों की संख्या जिनमें कोई ऐप्लिकेशन इंस्टॉल किया गया है

ऐसी प्रोफ़ाइलों की सूची देखने के लिए जिनमें कोई ऐप्लिकेशन इंस्टॉल किया गया है, findInstalledAppProfiles कस्टम तरीके का इस्तेमाल किया जा सकता है. pageSize और pageToken पैरामीटर का इस्तेमाल करके, नतीजों के पेज नंबर तय किए जा सकते हैं.

अनुरोध

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppProfiles?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

जवाब

{
  "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"
    },
  ]
}

फ़ॉलो-अप अनुरोध

पिछले उदाहरण में दिखाए गए प्रोफ़ाइल के परमानेंट आईडी की मदद से, Chrome Management Profiles API का इस्तेमाल करके, उस प्रोफ़ाइल के बारे में ज़्यादा जानकारी पाई जा सकती है जिस पर ऐप्लिकेशन इंस्टॉल किया गया है.

सैस के इस्तेमाल की जानकारी पाना

अपने संगठन में, SaaS ऐप्लिकेशन के कुल इस्तेमाल की जानकारी देखने के लिए, findSaasUsage कस्टम तरीके का इस्तेमाल करें. filter पैरामीटर का इस्तेमाल करके, नतीजों को फ़िल्टर किया जा सकता है. साथ ही, orderBy का इस्तेमाल करके, उन्हें क्रम से लगाया जा सकता है. pageSize और pageToken पैरामीटर का इस्तेमाल करके, नतीजों के पेज नंबर तय किए जा सकते हैं.

अनुरोध

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsage"

जवाब

{
  "saasReports": [
    {
      "app": "GitHub",
      "firstNavigationTime": "2026-01-01T00:00:00Z",
      "lastNavigationTime": "2026-01-01T10:00:00Z",
      "visitsCount": "100",
      "distinctBrowsersCount": "1",
      "distinctUsersCount": "0",
      "encryptionProtocols": [
        "TLS_1_3"
      ]
    },
    {
      "app": "Slack",
      "firstNavigationTime": "2026-01-02T00:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "visitsCount": "25",
      "distinctBrowsersCount": "1",
      "distinctUsersCount": "2",
      "encryptionProtocols": [
        "QUIC",
        "TLS_1_2"
      ]
    }
  ],
  "totalSize": "2"
}

प्रोफ़ाइल के हिसाब से ग्रुप करके, SaaS ऐप्लिकेशन के इस्तेमाल की जानकारी पाना

प्रोफ़ाइल के हिसाब से ग्रुप करके, किसी खास ऐप्लिकेशन के लिए SaaS ऐप्लिकेशन के इस्तेमाल की जानकारी देखने के लिए, findSaasUsageProfiles कस्टम तरीके का इस्तेमाल करें. app पैरामीटर, SaaS ऐप्लिकेशन की जानकारी देता है. filter पैरामीटर का इस्तेमाल करके, नतीजों को फ़िल्टर किया जा सकता है. साथ ही, orderBy का इस्तेमाल करके, उन्हें क्रम से लगाया जा सकता है. pageSize और pageToken पैरामीटर का इस्तेमाल करके, नतीजों के पेज नंबर तय किए जा सकते हैं.

अनुरोध

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsageProfiles?app=Slack"

जवाब

{
  "profileReports": [
    {
      "email": "user1@example.com",
      "profilePermanentId": "profile-permanent-id-1",
      "firstNavigationTime": "2026-01-03T10:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205c",
      "osPlatform": "SYSTEM_WINDOWS",
      "osVersion": "10.0.19044"
    },
    {
      "email": "user2@example.com",
      "profilePermanentId": "profile-permanent-id-2",
      "firstNavigationTime": "2026-01-03T10:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205c",
      "osPlatform": "SYSTEM_MAC",
      "osVersion": "12.3.1"
    }
  ],
  "totalSize": "2"
}

फ़ॉलो-अप अनुरोध

पिछले उदाहरण में दिखाए गए प्रोफ़ाइल के परमानेंट आईडी की मदद से, Chrome Management Profiles API का इस्तेमाल करके, प्रोफ़ाइल के बारे में ज़्यादा जानकारी पाई जा सकती है.

ब्राउज़र के हिसाब से ग्रुप करके, SaaS ऐप्लिकेशन के इस्तेमाल की जानकारी पाना

ब्राउज़र के हिसाब से ग्रुप करके, किसी खास ऐप्लिकेशन के लिए SaaS ऐप्लिकेशन के इस्तेमाल की जानकारी देखने के लिए, findSaasUsageBrowsers कस्टम तरीके का इस्तेमाल करें. app पैरामीटर, SaaS ऐप्लिकेशन की जानकारी देता है. filter पैरामीटर का इस्तेमाल करके, नतीजों को फ़िल्टर किया जा सकता है. साथ ही, orderBy का इस्तेमाल करके, उन्हें क्रम से लगाया जा सकता है. pageSize और pageToken पैरामीटर का इस्तेमाल करके, नतीजों के पेज नंबर तय किए जा सकते हैं.

अनुरोध

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsageBrowsers?app=GitHub"

जवाब

{
  "saasUsageBrowsers": [
    {
      "machine": "machine1",
      "devicePermanentId": "device1",
      "firstNavigationTime": "2026-01-01T00:00:00Z",
      "lastNavigationTime": "2026-01-01T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205b",
      "osPlatform": "SYSTEM_WINDOWS",
      "osVersion": "10.0.19042"
    }
  ],
  "totalSize": "1"
}