Method: properties.runRealtimeReport

Google Analytics রিয়েলটাইম API আপনার সম্পত্তির জন্য রিয়েলটাইম ইভেন্ট ডেটার একটি কাস্টমাইজড রিপোর্ট প্রদান করে। এই প্রতিবেদনগুলি গত 30 মিনিটের ঘটনা এবং ব্যবহার দেখায়৷

HTTP অনুরোধ

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runRealtimeReport

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

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

পরামিতি
property

string

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

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

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

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

JSON প্রতিনিধিত্ব
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "returnPropertyQuota": boolean
}
ক্ষেত্র
dimensions[]

object ( Dimension )

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

metrics[]

object ( Metric )

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

limit

string ( int64 format)

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

dimensionFilter

object ( FilterExpression )

মাত্রার ফিল্টার ক্লজ। মাত্রা এই ফিল্টার ব্যবহার করার জন্য অনুরোধ করা আবশ্যক. এই ফিল্টারে মেট্রিক্স ব্যবহার করা যাবে না।

metricFilter

object ( FilterExpression )

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

metricAggregations[]

enum ( MetricAggregation )

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

orderBys[]

object ( OrderBy )

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

returnPropertyQuota

boolean

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

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

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

একটি অনুরোধের সাথে সম্পর্কিত প্রতিক্রিয়া রিয়েলটাইম রিপোর্ট টেবিল।

JSON প্রতিনিধিত্ব
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "totals": [
    {
      object (Row)
    }
  ],
  "maximums": [
    {
      object (Row)
    }
  ],
  "minimums": [
    {
      object (Row)
    }
  ],
  "rowCount": integer,
  "propertyQuota": {
    object (PropertyQuota)
  }
}
ক্ষেত্র
dimensionHeaders[]

object ( DimensionHeader )

মাত্রা কলাম বর্ণনা করে। ডাইমেনশন হেডারের সংখ্যা এবং ডাইমেনশন হেডারের ক্রম সারিতে উপস্থিত মাত্রার সাথে মেলে।

metricHeaders[]

object ( MetricHeader )

মেট্রিক কলাম বর্ণনা করে। মেট্রিকহেডারের সংখ্যা এবং মেট্রিক হেডারের ক্রম সারিতে উপস্থিত মেট্রিকের সাথে মেলে।

rows[]

object ( Row )

রিপোর্টে মাত্রা মান সমন্বয় এবং মেট্রিক মানের সারি।

totals[]

object ( Row )

অনুরোধ করা হলে, মেট্রিক্সের মোট মান।

maximums[]

object ( Row )

অনুরোধ করা হলে, মেট্রিক্সের সর্বোচ্চ মান।

minimums[]

object ( Row )

অনুরোধ করা হলে, মেট্রিক্সের ন্যূনতম মান।

rowCount

integer

প্রশ্নের ফলাফলে সারির মোট সংখ্যা, উত্তরে যত সারির সংখ্যাই থাকুক না কেন। উদাহরণস্বরূপ, যদি একটি ক্যোয়ারী 175টি সারি প্রদান করে এবং API অনুরোধে সীমা = 50 অন্তর্ভুক্ত করে, প্রতিক্রিয়াটিতে rowCount = 175টি কিন্তু শুধুমাত্র 50টি সারি থাকবে।

propertyQuota

object ( PropertyQuota )

এই অনুরোধ সহ এই অ্যানালিটিক্স প্রপার্টির রিয়েলটাইম কোটার অবস্থা।

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

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

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