Method: properties.runRealtimeReport

আপনার প্রপার্টির জন্য রিয়েলটাইম ইভেন্ট ডেটার একটি কাস্টমাইজড রিপোর্ট প্রদান করে। ইভেন্টগুলো গুগল অ্যানালিটিক্সে পাঠানোর কয়েক সেকেন্ড পরেই রিয়েলটাইম রিপোর্টে প্রদর্শিত হয়। রিয়েলটাইম রিপোর্টে বর্তমান মুহূর্ত থেকে ৩০ মিনিট আগের (গুগল অ্যানালিটিক্স ৩৬০ প্রপার্টির জন্য ৬০ মিনিট পর্যন্ত) সময়কালের ইভেন্ট এবং ব্যবহারের ডেটা দেখানো হয়।

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

HTTP অনুরোধ

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

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

পথের পরামিতি

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

string

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

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

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

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

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 )

মেট্রিক্সের ফিল্টার ক্লজ। এটি অ্যাগ্রিগেশন-পরবর্তী পর্যায়ে প্রয়োগ করা হয়, যা SQL-এর having-clause-এর অনুরূপ। এই ফিল্টারে ডাইমেনশন ব্যবহার করা যায় না।

limit

string ( int64 format)

ফেরত দেওয়া সারির সংখ্যা। নির্দিষ্ট না করা হলে, ১০,০০০টি সারি ফেরত দেওয়া হয়। আপনি যতগুলোই অনুরোধ করুন না কেন, এপিআই প্রতি অনুরোধে সর্বোচ্চ ২,৫০,০০০টি সারি ফেরত দেয়। limit অবশ্যই ধনাত্মক হতে হবে।

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

metricAggregations[]

enum ( MetricAggregation )

মেট্রিকসমূহের একত্রীকরণ। যে সারিগুলিতে dimensionValues ​​"RESERVED_(MetricAggregation)" হিসাবে সেট করা আছে, সেখানে একত্রীকৃত মেট্রিক মানগুলি দেখানো হবে।

orderBys[]

object ( OrderBy )

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

returnPropertyQuota

boolean

এই গুগল অ্যানালিটিক্স প্রপার্টির রিয়েলটাইম কোটার বর্তমান অবস্থা দেখানো হবে কিনা, তা টগল করে। কোটা `PropertyQuota`- তে দেখানো হয়।

minuteRanges[]

object ( MinuteRange )

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

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

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

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

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 রিকোয়েস্ট প্যারামিটারের উপর নির্ভরশীল নয়। উদাহরণস্বরূপ, যদি একটি কোয়েরি ১৭৫টি সারি ফেরত দেয় এবং এপিআই রিকোয়েস্টে limit হিসেবে ৫০ অন্তর্ভুক্ত থাকে, তাহলে রেসপন্সে rowCount হিসেবে ১৭৫ থাকলেও সারির সংখ্যা হবে মাত্র ৫০টি।

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 । অনুরোধগুলি সর্বোচ্চ ২ মিনিটের পরিসরের জন্য অনুমোদিত।

JSON উপস্থাপনা 
{
  "name": string,
  "startMinutesAgo": integer,
  "endMinutesAgo": integer
}
ক্ষেত্র
name

string

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

startMinutesAgo

integer

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

অনির্দিষ্ট থাকলে, startMinutesAgo ডিফল্ট মান ২৯ হয়। স্ট্যান্ডার্ড অ্যানালিটিক্স প্রোপার্টিগুলো ইভেন্টের শেষ ৩০ মিনিট পর্যন্ত ডেটা অনুরোধ করতে পারে ( startMinutesAgo <= 29 ), এবং ৩৬০ অ্যানালিটিক্স প্রোপার্টিগুলো ইভেন্টের শেষ ৬০ মিনিট পর্যন্ত ডেটা অনুরোধ করতে পারে ( startMinutesAgo <= 59 )।

endMinutesAgo

integer

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

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