Method: properties.runRealtimeReport

আপনার সম্পত্তির জন্য রিয়েলটাইম ইভেন্ট ডেটার একটি কাস্টমাইজড রিপোর্ট প্রদান করে। ইভেন্টগুলি Google Analytics-এ পাঠানোর কয়েক সেকেন্ডের রিয়েলটাইম রিপোর্টে উপস্থিত হয়। রিয়েলটাইম রিপোর্ট বর্তমান মুহূর্ত থেকে 30 মিনিট আগে (Google Analytics 360 বৈশিষ্ট্যের জন্য 60 মিনিট পর্যন্ত) সময়ের জন্য ইভেন্ট এবং ব্যবহারের ডেটা দেখায়।

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

HTTP অনুরোধ

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

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

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

পরামিতি
property

string

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

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

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

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

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

object ( Dimension )

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

metrics[]

object ( Metric )

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

dimensionFilter

object ( FilterExpression )

মাত্রার ফিল্টার ক্লজ। এই ফিল্টারে মেট্রিক্স ব্যবহার করা যাবে না।

metricFilter

object ( FilterExpression )

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

limit

string ( int64 format)

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

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

metricAggregations[]

enum ( MetricAggregation )

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

orderBys[]

object ( OrderBy )

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

returnPropertyQuota

boolean

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

minuteRanges[]

object ( MinuteRange )

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

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

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

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

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

object ( DimensionHeader )

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

metricHeaders[]

object ( MetricHeader )

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

rows[]

object ( Row )

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

totals[]

object ( Row )

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

maximums[]

object ( Row )

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

minimums[]

object ( Row )

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

rowCount

integer

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

propertyQuota

object ( PropertyQuota )

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

kind

string

এই বার্তাটি কী ধরনের সংস্থান তা সনাক্ত করে৷ এই kind সবসময় নির্দিষ্ট স্ট্রিং "analyticsData#runRealtimeReport"। JSON-এ প্রতিক্রিয়া প্রকারের মধ্যে পার্থক্য করতে দরকারী।

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

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

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

মিনিটরেঞ্জ

মিনিটের একটি সংলগ্ন সেট: startMinutesAgo , startMinutesAgo + 1 , ..., endMinutesAgo । অনুরোধগুলি 2 মিনিটের ব্যাপ্তি পর্যন্ত অনুমোদিত।

JSON প্রতিনিধিত্ব
{
  "name": string,
  "startMinutesAgo": integer,
  "endMinutesAgo": integer
}
ক্ষেত্র
name

string

এই মিনিটের পরিসরে একটি নাম বরাদ্দ করে৷ একটি প্রতিবেদনের প্রতিক্রিয়ায় এই নামের জন্য মাত্রা dateRange মূল্য নির্ধারণ করা হয়েছে৷ সেট করা হলে, date_range_ বা RESERVED_ দিয়ে শুরু করা যাবে না। সেট না থাকলে, অনুরোধে মিনিটের ব্যাপ্তিগুলি তাদের শূন্য ভিত্তিক সূচক দ্বারা নামকরণ করা হয়: date_range_0 , date_range_1 , ইত্যাদি।

startMinutesAgo

integer

এখন থেকে কয়েক মিনিট আগে কোয়েরির জন্য অন্তর্ভুক্তিমূলক শুরু মিনিট। উদাহরণস্বরূপ, "startMinutesAgo": 29 উল্লেখ করে যে রিপোর্টে 29 মিনিট আগের এবং তার পরের ইভেন্ট ডেটা অন্তর্ভুক্ত করা উচিত। endMinutesAgo পর হতে পারে না।

অনির্দিষ্ট থাকলে, startMinutesAgo 29-এ ডিফল্ট হয়। স্ট্যান্ডার্ড অ্যানালিটিক্স বৈশিষ্ট্যগুলি ইভেন্ট ডেটার শেষ 30 মিনিট পর্যন্ত অনুরোধ করতে পারে ( startMinutesAgo <= 29 ), এবং 360 Analytics বৈশিষ্ট্যগুলি শেষ 60 মিনিটের ইভেন্ট ডেটা পর্যন্ত অনুরোধ করতে পারে ( startMinutesAgo <= 59 )

endMinutesAgo

integer

এখন থেকে কয়েক মিনিট আগে ক্যোয়ারীটির জন্য অন্তর্ভুক্তিমূলক শেষ মিনিট। startMinutesAgo এর আগে হতে পারে না। উদাহরণস্বরূপ, "endMinutesAgo": 15 উল্লেখ করে যে রিপোর্টে 15 মিনিট আগের ইভেন্ট ডেটা অন্তর্ভুক্ত করা উচিত।

অনির্দিষ্ট থাকলে, endMinutesAgo 0-তে ডিফল্ট হয়। স্ট্যান্ডার্ড অ্যানালিটিক্স বৈশিষ্ট্যগুলি ইভেন্ট ডেটার শেষ 30 মিনিটের যেকোনো মিনিটের জন্য অনুরোধ করতে পারে ( endMinutesAgo <= 29 ), এবং 360 Analytics বৈশিষ্ট্যগুলি ইভেন্ট ডেটার শেষ 60 মিনিটের যেকোনো মিনিটের জন্য অনুরোধ করতে পারে ( endMinutesAgo <= 59 )।