Method: properties.runAccessReport

ডেটা অ্যাক্সেস রেকর্ডের একটি কাস্টমাইজড রিপোর্ট প্রদান করে। প্রতিবেদনটি প্রতিটি ব্যবহারকারীর Google Analytics রিপোর্টিং ডেটা পড়ার রেকর্ড সরবরাহ করে। অ্যাক্সেস রেকর্ড 2 বছর পর্যন্ত ধরে রাখা হয়।

ডেটা অ্যাক্সেস রিপোর্ট একটি সম্পত্তি জন্য অনুরোধ করা যেতে পারে. যেকোন প্রপার্টির জন্য রিপোর্টের অনুরোধ করা যেতে পারে, কিন্তু কোটার সাথে সম্পর্কিত নয় এমন ডাইমেনশন শুধুমাত্র Google Analytics 360 প্রপার্টিতে অনুরোধ করা যেতে পারে। এই পদ্ধতি শুধুমাত্র প্রশাসকদের জন্য উপলব্ধ.

এই ডেটা অ্যাক্সেস রেকর্ডগুলির মধ্যে রয়েছে GA4 UI রিপোর্টিং, GA4 UI অন্বেষণ, GA4 ডেটা API, এবং Firebase এবং Admob-এর মতো অন্যান্য পণ্য যা লিঙ্কের মাধ্যমে Google Analytics থেকে ডেটা পুনরুদ্ধার করতে পারে। এই রেকর্ডগুলিতে প্রপার্টি কনফিগারেশন পরিবর্তনগুলি অন্তর্ভুক্ত নয় যেমন একটি স্ট্রীম যোগ করা বা প্রপার্টির সময় অঞ্চল পরিবর্তন করা। কনফিগারেশন পরিবর্তনের ইতিহাসের জন্য, দেখুন ChangeHistoryEvents অনুসন্ধান করুন ।

HTTP অনুরোধ

POST https://analyticsadmin.googleapis.com/v1beta/{entity=properties/*}:runAccessReport

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

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

পরামিতি
entity

string

ডেটা অ্যাক্সেস রিপোর্ট সম্পত্তি স্তর বা অ্যাকাউন্ট স্তরে অনুরোধ সমর্থন করে। যদি অ্যাকাউন্ট স্তরে অনুরোধ করা হয়, ডেটা অ্যাক্সেস রিপোর্টগুলি সেই অ্যাকাউন্টের অধীনে সমস্ত সম্পত্তির জন্য সমস্ত অ্যাক্সেস অন্তর্ভুক্ত করে।

প্রপার্টি লেভেলে অনুরোধ করার জন্য, এন্টিটি হতে হবে যেমন 'properties/123' যদি "123" আপনার GA4 প্রপার্টি আইডি হয়। অ্যাকাউন্ট লেভেলে অনুরোধ করার জন্য, এন্টিটি হতে হবে যেমন 'accounts/1234' যদি "1234" আপনার GA4 অ্যাকাউন্ট আইডি হয়।

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

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

JSON প্রতিনিধিত্ব
{
  "dimensions": [
    {
      object (AccessDimension)
    }
  ],
  "metrics": [
    {
      object (AccessMetric)
    }
  ],
  "dateRanges": [
    {
      object (AccessDateRange)
    }
  ],
  "dimensionFilter": {
    object (AccessFilterExpression)
  },
  "metricFilter": {
    object (AccessFilterExpression)
  },
  "offset": string,
  "limit": string,
  "timeZone": string,
  "orderBys": [
    {
      object (AccessOrderBy)
    }
  ],
  "returnEntityQuota": boolean,
  "includeAllUsers": boolean,
  "expandGroups": boolean
}
ক্ষেত্র
dimensions[]

object ( AccessDimension )

মাত্রা অনুরোধ এবং প্রতিক্রিয়া প্রদর্শিত. অনুরোধ 9 মাত্রা পর্যন্ত অনুমোদিত হয়.

metrics[]

object ( AccessMetric )

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

dateRanges[]

object ( AccessDateRange )

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

dimensionFilter

object ( AccessFilterExpression )

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

metricFilter

object ( AccessFilterExpression )

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

offset

string ( int64 format)

শুরুর সারির সারি গণনা। প্রথম সারিটি সারি 0 হিসাবে গণনা করা হয়। যদি অফসেটটি অনির্দিষ্ট থাকে তবে এটিকে 0 হিসাবে গণ্য করা হয়। যদি অফসেট শূন্য হয়, তবে এই পদ্ধতিটি limit এন্ট্রি সহ ফলাফলের প্রথম পৃষ্ঠাটি ফিরিয়ে দেবে।

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

limit

string ( int64 format)

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

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

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

timeZone

string

এই অনুরোধের সময় অঞ্চল যদি নির্দিষ্ট করা থাকে। অনির্দিষ্ট থাকলে, সম্পত্তির সময় অঞ্চল ব্যবহার করা হয়। অনুরোধের সময় অঞ্চল রিপোর্টের শুরু এবং শেষ তারিখ ব্যাখ্যা করতে ব্যবহৃত হয়।

IANA টাইম জোন ডাটাবেস থেকে স্ট্রিং হিসাবে ফর্ম্যাট করা হয়েছে ( https://www.iana.org/time-zones) ; যেমন "America/New_York" বা "Asia/Tokyo"।

orderBys[]

object ( AccessOrderBy )

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

returnEntityQuota

boolean

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

includeAllUsers

boolean

ঐচ্ছিক। প্রতিক্রিয়ায় এমন ব্যবহারকারীদের অন্তর্ভুক্ত করা হবে কিনা যারা কখনও API কল করেননি তা নির্ধারণ করে। সত্য হলে, নির্দিষ্ট সম্পত্তি বা অ্যাকাউন্টে অ্যাক্সেস সহ সমস্ত ব্যবহারকারীদের প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হয়, তারা একটি API কল করেছে বা না করেছে তা নির্বিশেষে। যদি মিথ্যা হয়, শুধুমাত্র একটি API কল করা ব্যবহারকারীদের অন্তর্ভুক্ত করা হবে।

expandGroups

boolean

ঐচ্ছিক। ব্যবহারকারীদের গ্রুপের মধ্যে ব্যবহারকারীদের ফিরিয়ে দিতে হবে কিনা তা নির্ধারণ করে। এই ক্ষেত্রটি তখনই কাজ করে যখন includeAllUsers সত্যে সেট করা থাকে। সত্য হলে, এটি নির্দিষ্ট সম্পত্তি বা অ্যাকাউন্টে অ্যাক্সেস সহ সমস্ত ব্যবহারকারীকে ফিরিয়ে দেবে। মিথ্যা হলে, শুধুমাত্র সরাসরি অ্যাক্সেস সহ ব্যবহারকারীদের ফিরিয়ে দেওয়া হবে।

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

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

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

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

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