Method: properties.audienceLists.query

ব্যবহারকারীদের একটি অডিয়েন্স তালিকা পুনরুদ্ধার করে। একটি অডিয়েন্স তৈরি করার পর, ব্যবহারকারীরা তাৎক্ষণিকভাবে তালিকাভুক্ত হওয়ার জন্য উপলব্ধ হন না। প্রথমে, ব্যবহারকারীদের একটি অডিয়েন্স তালিকা তৈরি করার জন্য audienceLists.create এ একটি অনুরোধ করা প্রয়োজন, এবং তারপর দ্বিতীয়ত, অডিয়েন্স তালিকা থেকে ব্যবহারকারীদের পুনরুদ্ধার করতে এই পদ্ধতিটি ব্যবহৃত হয়।

উদাহরণসহ অডিয়েন্স লিস্টের পরিচিতির জন্য "ক্রিয়েটিং অ্যান অডিয়েন্স লিস্ট" দেখুন।

গুগল অ্যানালিটিক্স ৪-এর অডিয়েন্স আপনাকে আপনার ব্যবসার জন্য গুরুত্বপূর্ণ উপায়ে ব্যবহারকারীদের ভাগ করার সুযোগ দেয়। আরও জানতে, দেখুন https://support.google.com/analytics/answer/9267572 ।

এই পদ্ধতিটি audienceExports.query- তে বিটা স্ট্যাবিলিটি পর্যায়ে উপলব্ধ। এই API সম্পর্কে আপনার মতামত জানাতে, Google Analytics Audience Export API Feedback ফর্মটি পূরণ করুন।

HTTP অনুরোধ

POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:query

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

পথের পরামিতি

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

string

আবশ্যক। যে অডিয়েন্স তালিকা থেকে ব্যবহারকারীদের আনা হবে, তার নাম। ফরম্যাট: properties/{property}/audienceLists/{audienceList}

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

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

JSON উপস্থাপনা 
{
  "offset": string,
  "limit": string
}
ক্ষেত্র
offset

string ( int64 format)

ঐচ্ছিক। শুরুর সারির সারি সংখ্যা। প্রথম সারিকে সারি ০ হিসাবে গণনা করা হয়।

পেজিং করার সময়, প্রথম অনুরোধে অফসেট নির্দিষ্ট করা হয় না; অথবা সমতুল্যভাবে, অফসেটকে ০-তে সেট করা হয়; সেক্ষেত্রে প্রথম অনুরোধটি সারির প্রথম limit পর্যন্ত ফেরত দেয়। দ্বিতীয় অনুরোধে অফসেটকে প্রথম অনুরোধের limit সমান সেট করা হয়; সেক্ষেত্রে দ্বিতীয় অনুরোধটি সারির দ্বিতীয় limit ফেরত দেয়।

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

limit

string ( int64 format)

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

যদি limit অনুযায়ী ডাইমেনশন ভ্যালুর সংখ্যা যথেষ্ট না থাকে, তাহলে এপিআই অনুরোধ করা limit চেয়ে কম সারিও ফেরত দিতে পারে।

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

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

দর্শক তালিকায় থাকা ব্যবহারকারীদের তালিকা।

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

JSON উপস্থাপনা 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceList": {
    object (AudienceList)
  },
  "rowCount": integer
}
ক্ষেত্র
audienceRows[]

object ( AudienceRow )

একটি অডিয়েন্স লিস্টের প্রতিটি ব্যবহারকারীর জন্য সারি সংখ্যা। এই রেসপন্সের সারির সংখ্যা রিকোয়েস্টের পেজ সাইজের চেয়ে কম বা সমান হবে।

audienceList

object ( AudienceList )

যে AudienceList-টি কোয়েরি করা হচ্ছে, তার কনফিগারেশন ডেটা। এই রেসপন্সের অডিয়েন্স সারিগুলো ব্যাখ্যা করতে সাহায্য করার জন্য এটি ফেরত দেওয়া হয়। উদাহরণস্বরূপ, এই AudienceList-এর ডাইমেনশনগুলো AudienceRows-এর কলামগুলোর সাথে সঙ্গতিপূর্ণ।

rowCount

integer

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

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

অনুমোদনের পরিধি

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

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

দর্শক সারি

অডিয়েন্স ইউজার রো-এর জন্য ডাইমেনশন ভ্যালু অ্যাট্রিবিউটসমূহ।

JSON উপস্থাপনা 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
ক্ষেত্র
dimensionValues[]

object ( AudienceDimensionValue )

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

শ্রোতা মাত্রা মান

একটি মাত্রার মান।

JSON উপস্থাপনা 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "value": string
  // End of mutually exclusive fields.
}
ক্ষেত্র
এক ধরনের ডাইমেনশন ভ্যালু। নিচে পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি রেসপন্সে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
value

string

ডাইমেনশন টাইপ স্ট্রিং হলে মানটিও স্ট্রিং হিসেবে গণ্য হবে।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।