Method: properties.runReport

আপনার গুগল অ্যানালিটিক্স ইভেন্ট ডেটার একটি কাস্টমাইজড রিপোর্ট প্রদান করে। রিপোর্টগুলোতে গুগল অ্যানালিটিক্স ট্র্যাকিং কোড দ্বারা সংগৃহীত ডেটা থেকে প্রাপ্ত পরিসংখ্যান থাকে। এপিআই থেকে প্রাপ্ত ডেটা একটি টেবিল আকারে থাকে, যেখানে অনুরোধ করা ডাইমেনশন এবং মেট্রিক্সের জন্য কলাম থাকে। মেট্রিক্স হলো আপনার প্রপার্টিতে ব্যবহারকারীর কার্যকলাপের স্বতন্ত্র পরিমাপ, যেমন সক্রিয় ব্যবহারকারী বা ইভেন্টের সংখ্যা। ডাইমেনশনগুলো কিছু সাধারণ মানদণ্ড, যেমন দেশ বা ইভেন্টের নামের উপর ভিত্তি করে মেট্রিক্সকে বিভক্ত করে।

অনুরোধ তৈরি করা ও তার প্রতিক্রিয়া বোঝার নির্দেশিকার জন্য, ‘একটি প্রতিবেদন তৈরি করা’ দেখুন।

HTTP অনুরোধ

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runReport

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

পথের পরামিতি

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

string

একটি গুগল অ্যানালিটিক্স প্রপার্টি আইডেন্টিফায়ার যার ইভেন্টগুলো ট্র্যাক করা হয়। এটি ইউআরএল পাথে নির্দিষ্ট করা থাকে, বডিতে নয়। আরও জানতে, আপনার প্রপার্টি আইডি কোথায় পাবেন তা দেখুন। একটি ব্যাচ রিকোয়েস্টের মধ্যে, এই প্রপার্টিটি হয় অনির্দিষ্ট থাকবে অথবা ব্যাচ-লেভেল প্রপার্টির সাথে সামঞ্জস্যপূর্ণ হবে।

উদাহরণ: প্রোপার্টি/১২৩৪

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

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

JSON উপস্থাপনা 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
ক্ষেত্র
dimensions[]

object ( Dimension )

অনুরোধকৃত ও প্রদর্শিত মাত্রা।

metrics[]

object ( Metric )

অনুরোধকৃত মেট্রিকগুলো প্রদর্শিত হলো।

dateRanges[]

object ( DateRange )

পড়ার জন্য ডেটার তারিখের পরিসর। যদি একাধিক তারিখের পরিসরের জন্য অনুরোধ করা হয়, তাহলে প্রতিটি প্রতিক্রিয়া সারিতে একটি শূন্য-ভিত্তিক তারিখের পরিসর সূচক থাকবে। যদি দুটি তারিখের পরিসর একে অপরের সাথে ওভারল্যাপ করে, তাহলে ওভারল্যাপ করা দিনগুলির ইভেন্টের ডেটা উভয় তারিখের পরিসরের প্রতিক্রিয়া সারিগুলিতে অন্তর্ভুক্ত করা হয়। একটি কোহর্ট অনুরোধে, এই dateRanges অবশ্যই অনির্দিষ্ট থাকতে হবে।

dimensionFilter

object ( FilterExpression )

ডাইমেনশন ফিল্টার আপনাকে রিপোর্টে শুধুমাত্র নির্দিষ্ট ডাইমেনশন ভ্যালুগুলো অন্তর্ভুক্ত করার সুযোগ দেয়। আরও জানতে, উদাহরণের জন্য ‘ডাইমেনশন ফিল্টারের মৌলিক বিষয়াবলী’ দেখুন। এই ফিল্টারে মেট্রিক ব্যবহার করা যায় না।

metricFilter

object ( FilterExpression )

মেট্রিক্সের ফিল্টার ক্লজ। রিপোর্টের সারিগুলো অ্যাগ্রিগেট করার পর এটি প্রয়োগ করা হয়, যা SQL-এর having-clause-এর অনুরূপ। এই ফিল্টারে ডাইমেনশন ব্যবহার করা যায় না।

offset

string ( int64 format)

শুরুর সারির সারি সংখ্যা। প্রথম সারিকে সারি ০ হিসাবে গণনা করা হয়।

পেজিং করার সময়, প্রথম অনুরোধে অফসেট নির্দিষ্ট করা হয় না; অথবা সমতুল্যভাবে, অফসেটকে ০-তে সেট করা হয়; সেক্ষেত্রে প্রথম অনুরোধটি সারির প্রথম limit পর্যন্ত ফেরত দেয়। দ্বিতীয় অনুরোধে অফসেটকে প্রথম অনুরোধের limit সমান সেট করা হয়; সেক্ষেত্রে দ্বিতীয় অনুরোধটি সারির দ্বিতীয় limit ফেরত দেয়।

এই পেজিনেশন প্যারামিটার সম্পর্কে আরও জানতে, পেজিনেশন দেখুন।

limit

string ( int64 format)

ফেরত দেওয়া সারির সংখ্যা। নির্দিষ্ট না করা হলে, ১০,০০০টি সারি ফেরত দেওয়া হয়। আপনি যতগুলোই অনুরোধ করুন না কেন, এপিআই প্রতি অনুরোধে সর্বোচ্চ ২,৫০,০০০টি সারি ফেরত দেয়। limit অবশ্যই ধনাত্মক হতে হবে।

যদি limit অনুযায়ী ডাইমেনশন ভ্যালুর সংখ্যা যথেষ্ট না থাকে, তাহলে এপিআই অনুরোধ করা limit চেয়ে কম সারিও ফেরত দিতে পারে। উদাহরণস্বরূপ, country ডাইমেনশনের জন্য ৩০০-এর কম সম্ভাব্য ভ্যালু রয়েছে, তাই শুধুমাত্র country এর উপর রিপোর্ট করার সময়, আপনি limit একটি উচ্চতর মানে সেট করলেও ৩০০-এর বেশি সারি পেতে পারবেন না।

এই পেজিনেশন প্যারামিটার সম্পর্কে আরও জানতে, পেজিনেশন দেখুন।

metricAggregations[]

enum ( MetricAggregation )

মেট্রিকের সমষ্টি। যে সারিগুলিতে dimensionValues ​​"RESERVED_(MetricAggregation)" হিসাবে সেট করা আছে, সেখানে সমষ্টিগত মেট্রিক মানগুলি দেখানো হবে। তুলনা এবং একাধিক তারিখের পরিসর উভয়ই অন্তর্ভুক্ত থাকা সমষ্টিগুলি তারিখের পরিসরের উপর ভিত্তি করে একত্রিত করা হবে।

orderBys[]

object ( OrderBy )

রেসপন্সে সারিগুলো কীভাবে সাজানো হবে তা নির্দিষ্ট করে। যেসব অনুরোধে তুলনা এবং একাধিক তারিখের পরিসর উভয়ই অন্তর্ভুক্ত থাকে, সেগুলোর ক্ষেত্রে তুলনার উপর অর্ডার বাই প্রয়োগ করা হবে।

currencyCode

string

ISO4217 ফরম্যাটে একটি মুদ্রা কোড, যেমন 'AED', 'USD', 'JPY'। যদি ফিল্ডটি খালি থাকে, তাহলে রিপোর্টটি প্রপার্টির ডিফল্ট মুদ্রা ব্যবহার করে।

cohortSpec

object ( CohortSpec )

এই অনুরোধের সাথে সংশ্লিষ্ট কোহর্ট গ্রুপ। অনুরোধে কোনো কোহর্ট গ্রুপ থাকলে 'কোহর্ট' ডাইমেনশনটি অবশ্যই উপস্থিত থাকতে হবে।

keepEmptyRows

boolean

যদি false বা অনির্দিষ্ট থাকে, তাহলে যে সারিগুলোর সব মেট্রিক 0 হবে, সেগুলো ফেরত দেওয়া হবে না। যদি true হয়, তাহলে এই সারিগুলো ফেরত দেওয়া হবে, যদি না কোনো ফিল্টার দ্বারা সেগুলোকে আলাদাভাবে সরানো হয়।

এই keepEmptyRows সেটিং নির্বিশেষে, একটি রিপোর্টে শুধুমাত্র গুগল অ্যানালিটিক্স প্রপার্টি দ্বারা রেকর্ড করা ডেটাই প্রদর্শন করা যাবে।

উদাহরণস্বরূপ, যদি কোনো প্রপার্টি কখনও কোনো purchase ইভেন্ট লগ না করে, তাহলে eventName ডাইমেনশন এবং eventCount মেট্রিকের জন্য করা কোয়েরিতে eventName: "purchase" এবং eventCount: 0 নামের কোনো রো থাকবে না।

returnPropertyQuota

boolean

এই গুগল অ্যানালিটিক্স প্রপার্টির কোটার বর্তমান অবস্থা দেখানো হবে কিনা, তা টগল করে। কোটা `PropertyQuota`- তে দেখানো হয়।

comparisons[]

object ( Comparison )

ঐচ্ছিক। অনুরোধকৃত এবং প্রদর্শিত তুলনাগুলোর বিন্যাস। প্রতিক্রিয়ায় একটি তুলনা কলাম পাওয়ার জন্য অনুরোধটিতে শুধুমাত্র একটি 'তুলনা' ফিল্ড থাকা প্রয়োজন।

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

সফল হলে, রেসপন্স বডিতে RunReportResponse এর একটি ইনস্ট্যান্স থাকে।

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

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

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics