Method: vitals.crashrate.query

মেট্রিক সেটে মেট্রিক কোয়েরি করে।

HTTP অনুরোধ

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}:query

URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।

পাথ প্যারামিটার

প্যারামিটারগুলি
name

string

প্রয়োজনীয়। রিসোর্সের নাম।

ফর্ম্যাট: apps/{app}/crashRateMetricSet

অনুরোধের বডি

অনুরোধের প্রধান অংশে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
ফিল্ড
timelineSpec

object (TimelineSpec)

ঐচ্ছিক। টাইমলাইন অ্যাগ্রিগেশন প্যারামিটারের স্পেসিফিকেশন।

এগ্রিগেশনের জন্য কাজ করে এমন সময়সীমা:

  • DAILY: মেট্রিক ক্যালেন্ডার তারিখের ব্যবধানে একত্রিত করা হয়। ঐতিহাসিক বাধ্যবাধকতার কারণে, ডিফল্ট এবং একমাত্র কাজ করে এমন টাইমজোন হল America/Los_Angeles।
  • HOURLY: মেট্রিক্স প্রতি ঘণ্টার ব্যবধানে একত্রিত করা হয়। ডিফল্ট এবং একমাত্র কাজ করে এমন টাইমজোন হল UTC।
dimensions[]

string

ঐচ্ছিক। মেট্রিক স্লাইস করার জন্য ডাইমেনশন।

যেসব ডাইমেনশন কাজ করে:

  • apiLevel (string): ব্যবহারকারীর ডিভাইসে চলা Android-এর API লেভেল, যেমন, ২৬।
  • versionCode (int64): ব্যবহারকারীর ডিভাইসে চলা অ্যাপের ভার্সন।
  • deviceModel (string): ব্যবহারকারীর ডিভাইস মডেলের অনন্য শনাক্তকারী। শনাক্তকারীর ফর্ম হল 'deviceBrand/device', যেখানে deviceBrand হল Build.BRAND এবং device হল Build.DEVICE, যেমন, google/coral.
  • deviceBrand (string): ব্যবহারকারীর ডিভাইসের ব্র্যান্ডের অনন্য শনাক্তকারী, যেমন, google.
  • deviceType (string): ব্যবহারকারীর ডিভাইসের ধরন (ফর্ম ফ্যাক্টর হিসেবেও পরিচিত), যেমন, ফোন।
  • countryCode (string): ব্যবহারকারীর IP অ্যাড্রেসের উপর ভিত্তি করে তার ডিভাইসের দেশ বা অঞ্চল, যা ২-অক্ষরের ISO-3166 কোড হিসেবে দেখানো হয় (যেমন, মার্কিন যুক্তরাষ্ট্রের জন্য US)।
  • deviceRamBucket (int64): ডিভাইসের RAM, MB-তে, বাকেটে (যেমন, ১-১.৫ জিবির জন্য ১০২৪, ৪-৬ জিবির জন্য ৪০৯৬)।
  • deviceSocMake (string): ডিভাইসের প্রাইমারি সিস্টেম-অন-চিপের মেক, যেমন, Samsung. রেফারেন্স
  • deviceSocModel (string): ডিভাইসের প্রাইমারি সিস্টেম-অন-চিপের মডেল, যেমন, "Exynos 2100"। রেফারেন্স
  • deviceCpuMake (string): ডিভাইসের CPU-এর প্রস্তুতকারক, যেমন, Qualcomm.
  • deviceCpuModel (string): ডিভাইসের CPU-এর মডেল, যেমন, "Kryo 240"।
  • deviceGpuMake (string): ডিভাইসের GPU-এর প্রস্তুতকারক, যেমন, ARM.
  • deviceGpuModel (string): ডিভাইসের GPU-এর মডেল, যেমন, Mali.
  • deviceGpuVersion (string): ডিভাইসের GPU-এর ভার্সন, যেমন, T750.
  • deviceVulkanVersion (string): ডিভাইসের Vulkan ভার্সন, যেমন, "৪১৯৮৪০০"।
  • deviceGlEsVersion (string): ডিভাইসের OpenGL ES ভার্সন, যেমন, "১৯৬৬১০"।
  • deviceScreenSize (string): ডিভাইসের স্ক্রিনের সাইজ, যেমন, সাধারণ, বড়।
  • deviceScreenDpi (string): ডিভাইসের স্ক্রিন ডেনসিটি, যেমন, mdpi, hdpi.
metrics[]

string

ঐচ্ছিক। মেট্রিক্স একত্রিত করতে হবে।

কাজ করে এমন মেট্রিক:

  • crashRate (google.type.Decimal): অ্যাগ্রিগেশন সময়সীমার মধ্যে অন্তত একবার ক্র্যাশ হওয়ার অভিজ্ঞতা হয়েছে এমন স্বতন্ত্র ব্যবহারকারীর শতাংশ।
  • crashRate7dUserWeighted (google.type.Decimal): গত ৭ দিনে crashRate-এর রোলিং গড় ভ্যালু। দিনের জন্য স্বতন্ত্র ব্যবহারকারীর সংখ্যা দ্বারা দৈনিক মানগুলি ওজন করা হয়।
  • crashRate28dUserWeighted (google.type.Decimal): গত ২৮ দিনে crashRate-এর রোলিং গড় ভ্যালু। দিনের জন্য স্বতন্ত্র ব্যবহারকারীর সংখ্যা দ্বারা দৈনিক মানগুলি ওজন করা হয়। HOURLY গ্র্যানুলারিটিতে কাজ করে না।
  • userPerceivedCrashRate (google.type.Decimal): অ্যাগ্রিগেশন সময়সীমার মধ্যে আপনার অ্যাপ অ্যাক্টিভভাবে ব্যবহার করার সময় অন্তত একবার ক্র্যাশ (ব্যবহারকারীর-লক্ষ্য করা ক্র্যাশ) হওয়ার অভিজ্ঞতা হয়েছে এমন অনন্য ব্যবহারকারীর শতাংশ। কোনও অ্যাপ কোনও অ্যাক্টিভিটি দেখালে বা কোনও ফোরগ্রাউন্ড সার্ভিস এক্সিকিউট করলে, সেটি অ্যাক্টিভভাবে ব্যবহার করা হচ্ছে বলে বিবেচনা করা হয়।
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): গত ৭ দিনে userPerceivedCrashRate-এর রোলিং গড় ভ্যালু। দিনের জন্য স্বতন্ত্র ব্যবহারকারীর সংখ্যা দ্বারা দৈনিক মানগুলি ওজন করা হয়। HOURLY গ্র্যানুলারিটিতে কাজ করে না।
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): গত ২৮ দিনে userPerceivedCrashRate-এর রোলিং গড় ভ্যালু। দিনের জন্য স্বতন্ত্র ব্যবহারকারীর সংখ্যা দ্বারা দৈনিক মানগুলি ওজন করা হয়। HOURLY গ্র্যানুলারিটিতে কাজ করে না।
  • distinctUsers (google.type.Decimal): এগ্রিগেশন সময়সীমার মধ্যে অনন্য ব্যবহারকারীর সংখ্যা যা crashRate এবং userPerceivedCrashRate মেট্রিকের জন্য নরমালাইজেশন ভ্যালু হিসেবে ব্যবহার করা হয়েছে। অ্যাগ্রিগেশন সময়সীমার মধ্যে কোনও ব্যবহারকারী অ্যাপটি সক্রিয়ভাবে ব্যবহার করলে, তাকে এই মেট্রিকের মধ্যে গণনা করা হয়। কোনও অ্যাপ কোনও অ্যাক্টিভিটি দেখালে বা কোনও ফোরগ্রাউন্ড সার্ভিস এক্সিকিউট করলে, সেটি অ্যাক্টিভভাবে ব্যবহার করা হচ্ছে বলে বিবেচনা করা হয়। এই সংখ্যাটি যাতে আরও বেশি না হয় সেই ব্যাপারে যত্ন নিতে হবে, কারণ এর ফলে ব্যবহারকারীদের একাধিকবার গণনা করা হতে পারে। ভ্যালুর পরিমাণের উপর নির্ভর করে, ভ্যালুটি ১০, ১০০,১,০০০ বা ১,০০০, ০০০-এর নিকটতম গুণিতকে রাউন্ড করা হয়।
filter

string

ঐচ্ছিক। ডেটাতে প্রয়োগ করার জন্য ফিল্টার। ফিল্টারিং এক্সপ্রেশন AIP-160 স্ট্যান্ডার্ড অনুসরণ করে এবং সব ব্রেকডাউন ডাইমেনশনের সমতা অনুযায়ী ফিল্টারিং সমর্থন করে।

pageSize

integer

ঐচ্ছিক। ফেরত আসা ডেটার সর্বাধিক সাইজ।

অনির্দিষ্ট থাকলে, সর্বাধিক ১০০০টি সারি পাওয়া যাবে। সর্বাধিক ভ্যালু হল ১০,০০০; ১০,০০০-এর বেশি ভ্যালু থাকলে তা ১০,০০০ হিসেবেই গণ্য করা হবে।

pageToken

string

ঐচ্ছিক। আগের কল থেকে পাওয়া একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি ফিরিয়ে আনতে এটি প্রদান করুন।

পৃষ্ঠা সংখ্যা দেওয়ার সময়, অনুরোধে দেওয়া অন্যান্য সব প্যারামিটার অবশ্যই পৃষ্ঠা টোকেন প্রদানকারী কলের সাথে মিলতে হবে।

userCohort

enum (UserCohort)

ঐচ্ছিক। বেছে নেওয়ার জন্য ব্যবহারকারীর ভিউ। আউটপুট ডেটা বেছে নেওয়া ভিউ অনুযায়ী হবে।

সাপোর্ট করা ভ্যালু:

  • OS_PUBLIC সর্বজনীনভাবে রিলিজ করা সব Android ভার্সন থেকে ডেটা বেছে নিতে। এটি ডিফল্ট বিকল্প। উপরের সবকটি আকৃতির ক্ষেত্রে কাজ করে।
  • APP_TESTERS যেসব ব্যবহারকারী পরীক্ষক হিসেবে অপ্ট-ইন করেছেন তাদের থেকে ডেটা বেছে নিতে। উপরের সবকটি ডাইমেনশনে কাজ করে।
  • OS_BETA শুধুমাত্র বিটা Android ভার্সন থেকে ডেটা বেছে নিতে, রিলিজ করা Android ভার্সন থেকে ডেটা বাদ দিয়ে। শুধুমাত্র নিম্নলিখিত ডাইমেনশন কাজ করে:
  • versionCode (int64): ব্যবহারকারীর ডিভাইসে চলা অ্যাপের ভার্সন।

  • osBuild (string): ব্যবহারকারীর ডিভাইসের OS বিল্ড, যেমন, "T1B2.220916.004"।

প্রতিক্রিয়ার বডি

crashrate.query-এর জন্য উত্তর মেসেজ।

সফল হলে, প্রতিক্রিয়ার বডিতে নিচে উল্লেখ করা স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
ফিল্ড
rows[]

object (MetricsRow)

ডেটার সারি ফেরত দেওয়া হয়েছে।

nextPageToken

string

পরবর্তী পৃষ্ঠার ডেটা ফেচ করার জন্য কন্টিনিউয়েশন টোকেন।

অনুমোদনের স্কোপ

এটির জন্য নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/playdeveloperreporting

আরও তথ্যের জন্য, OAuth 2.0 Overview দেখুন।