Method: vitals.crashrate.query

মেট্রিক সেটে থাকা মেট্রিকগুলো কোয়েরি করে।

HTTP অনুরোধ

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

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

পথের পরামিতি

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

string

আবশ্যক। রিসোর্সের নাম।

ফরম্যাট: অ্যাপস/{অ্যাপ}/ক্র্যাশরেটমেট্রিকসেট

অনুরোধকারী শরীর

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

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 ): ব্যবহারকারীর ডিভাইসে চলমান অ্যান্ড্রয়েডের এপিআই লেভেল, যেমন, ২৬।
  • versionCode ( int64 ): ব্যবহারকারীর ডিভাইসে অ্যাপটির যে ভার্সনটি চলছিল।
  • deviceModel ( string ): ব্যবহারকারীর ডিভাইস মডেলের অনন্য শনাক্তকারী। শনাক্তকারীটির গঠন হলো 'deviceBrand/device', যেখানে deviceBrand হলো Build.BRAND এবং device হলো Build.DEVICE, যেমন, google/coral।
  • deviceBrand ( string ): ব্যবহারকারীর ডিভাইসের ব্র্যান্ডের অনন্য শনাক্তকারী, যেমন, গুগল।
  • deviceType ( string ): ব্যবহারকারীর ডিভাইসের ধরন (যা ফর্ম ফ্যাক্টর নামেও পরিচিত), যেমন, ফোন।
  • countryCode ( string ): ব্যবহারকারীর আইপি অ্যাড্রেসের উপর ভিত্তি করে তার ডিভাইসের দেশ বা অঞ্চল, যা একটি ২-অক্ষরের ISO-3166 কোড হিসাবে প্রকাশ করা হয় (যেমন মার্কিন যুক্তরাষ্ট্রের জন্য US)।
  • deviceRamBucket ( int64 ): ডিভাইসটির র‍্যাম, মেগাবাইটে, বিভিন্ন বাকেটে (যেমন ৩জিবি, ৪জিবি, ইত্যাদি)।
  • deviceSocMake ( string ): ডিভাইসটির প্রধান সিস্টেম-অন-চিপের প্রস্তুতকারক, যেমন, স্যামসাং। রেফারেন্স
  • deviceSocModel ( string ): ডিভাইসটির প্রধান সিস্টেম-অন-চিপের মডেল, যেমন, "Exynos 2100"। রেফারেন্স
  • deviceCpuMake ( string ): ডিভাইসটির সিপিইউ-এর প্রস্তুতকারক, যেমন, Qualcomm।
  • deviceCpuModel ( string ): ডিভাইসটির সিপিইউ-এর মডেল, যেমন, "Kryo 240"।
  • deviceGpuMake ( string ): ডিভাইসটির GPU-এর প্রস্তুতকারক, যেমন, ARM।
  • deviceGpuModel ( string ): ডিভাইসটির GPU-এর মডেল, যেমন, মালি।
  • deviceGpuVersion ( string ): ডিভাইসটির জিপিইউ-এর ভার্সন, যেমন, T750।
  • deviceVulkanVersion ( string ): ডিভাইসটির ভলকান সংস্করণ, যেমন, "4198400"।
  • deviceGlEsVersion ( string ): ডিভাইসটির OpenGL ES সংস্করণ, যেমন, "196610"।
  • 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 । এটিই ডিফল্ট। উপরের সমস্ত ডাইমেনশন সমর্থন করে।
  • APP_TESTERS যেসব ব্যবহারকারী পরীক্ষক হতে সম্মতি দিয়েছেন, তাদের থেকে ডেটা নির্বাচন করার জন্য। উপরের সমস্ত ডাইমেনশন সমর্থন করে।
  • OS_BETA শুধুমাত্র বিটা অ্যান্ড্রয়েড সংস্করণগুলো থেকে ডেটা নির্বাচন করার জন্য, প্রকাশিত অ্যান্ড্রয়েড সংস্করণগুলোর ডেটা বাদ দিয়ে। কেবল নিম্নলিখিত ডাইমেনশনগুলো সমর্থিত:

  • versionCode ( int64 ): ব্যবহারকারীর ডিভাইসে অ্যাপটির যে ভার্সনটি চলছিল।

  • osBuild ( string ): ব্যবহারকারীর ডিভাইসের ওএস বিল্ড, যেমন, "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 .