Method: properties.batchRunReports

একটি ব্যাচে একাধিক রিপোর্ট প্রদান করে। সমস্ত রিপোর্ট একই GA4 সম্পত্তির জন্য হতে হবে।

HTTP অনুরোধ

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

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

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

পরামিতি
property

string

একটি Google Analytics GA4 প্রপার্টি আইডেন্টিফায়ার যার ইভেন্ট ট্র্যাক করা হয়। URL পাথে নির্দিষ্ট করা হয়েছে এবং বডিতে নয়। আরও জানতে, আপনার সম্পত্তি আইডি কোথায় পাবেন তা দেখুন। এই সম্পত্তি ব্যাচ জন্য নির্দিষ্ট করা আবশ্যক. RunReportRequest-এর মধ্যে থাকা সম্পত্তি অনির্দিষ্ট বা এই সম্পত্তির সাথে সামঞ্জস্যপূর্ণ হতে পারে।

উদাহরণ: বৈশিষ্ট্য/1234

শরীরের অনুরোধ

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

JSON প্রতিনিধিত্ব 
{
  "requests": [
    {
      object (RunReportRequest)
    }
  ]
}
ক্ষেত্র
requests[]

object ( RunReportRequest )

ব্যক্তিগত অনুরোধ. প্রতিটি অনুরোধ একটি পৃথক রিপোর্ট প্রতিক্রিয়া আছে. প্রতিটি ব্যাচ অনুরোধ 5 অনুরোধ পর্যন্ত অনুমোদিত হয়.

প্রতিক্রিয়া শরীর

একাধিক রিপোর্ট ধারণকারী ব্যাচ প্রতিক্রিয়া.

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

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

RunReportRequest

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

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

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

উদাহরণ: বৈশিষ্ট্য/1234

dimensions[]

object ( Dimension )

মাত্রা অনুরোধ এবং প্রদর্শিত.

metrics[]

object ( Metric )

মেট্রিক্স অনুরোধ এবং প্রদর্শিত.

dateRanges[]

object ( DateRange )

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

dimensionFilter

object ( FilterExpression )

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

metricFilter

object ( FilterExpression )

মেট্রিক্সের ফিল্টার ক্লজ। রিপোর্টের সারিগুলি একত্রিত করার পরে প্রয়োগ করা হয়, এসকিউএল থাকা-ধারার মতো। এই ফিল্টারে মাত্রা ব্যবহার করা যাবে না।

offset

string ( int64 format)

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

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

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

limit

string ( int64 format)

যে সারিতে ফিরতে হবে। অনির্দিষ্ট থাকলে, 10,000 সারি ফেরত দেওয়া হয়। এপিআই প্রতি অনুরোধে সর্বাধিক 250,000 সারি প্রদান করে, আপনি যতই জিজ্ঞাসা করুন না কেন। limit ইতিবাচক হতে হবে।

এপিআই অনুরোধ করা limit চেয়ে কম সারিও দিতে পারে, যদি limit মতো অনেক মাত্রার মান না থাকে। উদাহরণস্বরূপ, মাত্রার country জন্য 300 টিরও কম সম্ভাব্য মান রয়েছে, তাই শুধুমাত্র country উপর রিপোর্ট করার সময়, আপনি 300 টির বেশি সারি পেতে পারবেন না, এমনকি যদি আপনি একটি উচ্চ মানের limit সেট করেন।

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

metricAggregations[]

enum ( MetricAggregation )

মেট্রিক্সের সমষ্টি। একত্রিত মেট্রিক মানগুলি সারিতে দেখানো হবে যেখানে মাত্রা মানগুলি "RESERVED_(MetricAggregation)" এ সেট করা আছে৷

orderBys[]

object ( OrderBy )

প্রতিক্রিয়াতে সারিগুলি কীভাবে সাজানো হয় তা নির্দিষ্ট করে।

currencyCode

string

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

cohortSpec

object ( CohortSpec )

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

keepEmptyRows

boolean

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

এই keepEmptyRows সেটিং যাই থাকুক না কেন, শুধুমাত্র Google Analytics (GA4) প্রপার্টি দ্বারা রেকর্ড করা ডেটা রিপোর্টে প্রদর্শিত হতে পারে।

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

returnPropertyQuota

boolean

এই অ্যানালিটিক্স প্রপার্টির কোটার বর্তমান অবস্থা ফিরিয়ে আনতে হবে কিনা তা টগল করে। প্রপার্টি কোটায় কোটা ফেরত দেওয়া হয়।

comparisons[]

object ( Comparison )

ঐচ্ছিক। তুলনার কনফিগারেশন অনুরোধ করা হয়েছে এবং দেখানো হয়েছে। প্রতিক্রিয়ায় একটি তুলনা কলাম পাওয়ার জন্য অনুরোধটির শুধুমাত্র একটি তুলনা ক্ষেত্র প্রয়োজন।