Method: properties.batchRunReports

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

HTTP অনুরোধ

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

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

পথের পরামিতি

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

string

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

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

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

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

JSON উপস্থাপনা 
{
  "requests": [
    {
      object (RunReportRequest)
    }
  ]
}
ক্ষেত্র
requests[]

object ( RunReportRequest )

স্বতন্ত্র অনুরোধ। প্রতিটি অনুরোধের জন্য একটি পৃথক প্রতিবেদন প্রতিক্রিয়া থাকে। প্রতিটি ব্যাচ অনুরোধে সর্বোচ্চ ৫টি অনুরোধ অনুমোদিত।

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

ব্যাচ প্রতিক্রিয়াটিতে একাধিক প্রতিবেদন রয়েছে।

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

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

object ( RunReportResponse )

স্বতন্ত্র প্রতিক্রিয়া। প্রতিটি প্রতিক্রিয়ার জন্য একটি পৃথক প্রতিবেদন অনুরোধ রয়েছে।

kind

string

এই বার্তাটি কোন ধরনের রিসোর্স তা শনাক্ত করে। এই kind সর্বদা "analyticsData#batchRunReports" এই নির্দিষ্ট স্ট্রিংটি হয়ে থাকে। JSON-এ রেসপন্স টাইপগুলোর মধ্যে পার্থক্য করতে এটি উপযোগী।

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

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

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

রানরিপোর্টঅনুরোধ

একটি প্রতিবেদন তৈরি করার অনুরোধ।

JSON উপস্থাপনা 
{
  "property": string,
  "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)
    }
  ]
}
ক্ষেত্র
property

string

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

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

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 )

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