Method: properties.runReport

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

অনুরোধ নির্মাণ এবং প্রতিক্রিয়া বোঝার গাইডের জন্য, একটি প্রতিবেদন তৈরি করা দেখুন।

HTTP অনুরোধ

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

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

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

পরামিতি
property

string

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

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

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

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

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 )

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

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 )

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

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

সফল হলে, প্রতিক্রিয়া বডিতে RunReportResponse এর একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

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

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