Method: vitals.excessivewakeuprate.query

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

HTTP অনুরোধ

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/excessiveWakeupRateMetricSet}: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 টাইমজোনটিই সমর্থিত।
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

ঐচ্ছিক। সমষ্টি করার জন্য মেট্রিকসমূহ।

সমর্থিত মেট্রিকসমূহ:

  • excessiveWakeupRate ( google.type.Decimal ): নির্দিষ্ট সময়কালে প্রতি ঘন্টায় ১০টির বেশি ঘুম থেকে জেগে ওঠা স্বতন্ত্র ব্যবহারকারীদের শতাংশ।
  • excessiveWakeupRate7dUserWeighted ( google.type.Decimal ): গত ৭ দিনের excessiveWakeupRate এর চলমান গড় মান। দৈনিক মানগুলো সেই দিনের স্বতন্ত্র ব্যবহারকারীর সংখ্যা দ্বারা ভারযুক্ত করা হয়।
  • excessiveWakeupRate28dUserWeighted ( google.type.Decimal ): গত ২৮ দিনের excessiveWakeupRate এর চলমান গড় মান। দৈনিক মানগুলো সেই দিনের স্বতন্ত্র ব্যবহারকারীর সংখ্যা দ্বারা ভারযুক্ত করা হয়।
  • distinctUsers ( google.type.Decimal ): অ্যাগ্রিগেশন পিরিয়ডে থাকা স্বতন্ত্র ব্যবহারকারীর সংখ্যা, যাদের excessiveWakeupRate মেট্রিকের জন্য নর্মালাইজেশন ভ্যালু হিসেবে ব্যবহার করা হয়েছে। একজন ব্যবহারকারীকে এই মেট্রিকের অন্তর্ভুক্ত করা হয় যদি তার অ্যাপটি ডিভাইসে কোনো কাজ করে থাকে, অর্থাৎ, শুধু সক্রিয় ফোরগ্রাউন্ড ব্যবহারই নয়, বরং ব্যাকগ্রাউন্ডের কাজও। এই সংখ্যাটিকে আরও অ্যাগ্রিগেট না করার ব্যাপারে সতর্ক থাকতে হবে, কারণ এর ফলে ব্যবহারকারীরা একাধিকবার গণনার শিকার হতে পারেন। মানটির পরিমাণের উপর নির্ভর করে এটিকে ১০, ১০০, ১,০০০ বা ১,০০০,০০০-এর নিকটতম গুণিতকে রাউন্ড করা হয়।
filter

string

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

pageSize

integer

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

অনির্দিষ্ট থাকলে, সর্বাধিক ১০০০টি সারি ফেরত দেওয়া হবে। সর্বোচ্চ মান হলো ১০০০০০; ১০০০০০-এর উপরের মানগুলোকে ১০০০০০-এ রূপান্তরিত করা হবে।

pageToken

string

ঐচ্ছিক। পূর্ববর্তী কল থেকে প্রাপ্ত একটি পেজ টোকেন। পরবর্তী পেজটি পাওয়ার জন্য এটি প্রদান করুন।

পেজিনেশন করার সময়, অনুরোধে প্রদত্ত অন্য সকল প্যারামিটার অবশ্যই সেই কলের সাথে মিলতে হবে যা পেজ টোকেনটি প্রদান করেছে।

userCohort

enum ( UserCohort )

ঐচ্ছিক। ব্যবহারকারীর পছন্দের ভিউ। আউটপুট ডেটা নির্বাচিত ভিউ অনুযায়ী হবে। একমাত্র সমর্থিত মান হলো OS_PUBLIC ।

প্রতিক্রিয়া সংস্থা

excessivewakeuprate.query এর জন্য প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
rows[]

object ( MetricsRow )

ফেরত দেওয়া ডেটার সারিগুলো।

nextPageToken

string

ডেটার পরবর্তী পৃষ্ঠা আনার জন্য ধারাবাহিকতা টোকেন।

অনুমোদনের পরিধি

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

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

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