ক্রোম ম্যানেজমেন্ট রিপোর্ট API-এর জন্য কোড নমুনা

এপিআই বৈশিষ্ট্যগুলির একটি সংক্ষিপ্ত বিবরণের জন্য ক্রোম ম্যানেজমেন্ট রিপোর্টস এপিআই দেখুন।

নীচে দেখানো সমস্ত অনুরোধে নিম্নলিখিত ভেরিয়েবলগুলি ব্যবহার করা হয়েছে:

• $TOKEN - OAuth 2 টোকেন
• $CUSTOMER - গ্রাহকের আইডি অথবা আক্ষরিক অর্থে my_customer
• $ORG_UNIT_ID - একটি নির্দিষ্ট অর্গ ইউনিটের আইডি, যার জন্য আপনি একটি অনুরোধ তৈরি করতে চান।

একটি নির্দিষ্ট তারিখের পরিসরে সক্রিয় ক্রোম প্রোফাইল সংস্করণ সংখ্যা গণনা করুন

একটি নির্দিষ্ট সময়সীমার মধ্যে কোন ক্রোম প্রোফাইল সংস্করণগুলি সক্রিয় ছিল তা দেখতে, 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
}

একটি নির্দিষ্ট তারিখের পরিসরে সক্রিয় ক্রোম সংস্করণগুলির সংখ্যা গণনা করুন

একটি নির্দিষ্ট সময়সীমার মধ্যে কোন ক্রোম সংস্করণগুলো সক্রিয় ছিল তা দেখতে, 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 ব্যবহার খুঁজুন

আপনার প্রতিষ্ঠান জুড়ে 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": "[e-mail]",
      "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": "[e-mail]",
      "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"
}