Method: properties.audienceLists.query

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

উদাহরণ সহ শ্রোতা তালিকার ভূমিকার জন্য একটি শ্রোতা তালিকা তৈরি করা দেখুন।

Google Analytics 4-এর শ্রোতারা আপনাকে আপনার ব্যবহারকারীদের সেভাবে ভাগ করতে দেয় যা আপনার ব্যবসার জন্য গুরুত্বপূর্ণ। আরও জানতে, https://support.google.com/analytics/answer/9267572 দেখুন।

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

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)

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

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

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

limit

string ( int64 format)

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

এপিআই অনুরোধ করা limit চেয়ে কম সারিও দিতে পারে, যদি limit মতো অনেক মাত্রার মান না থাকে।

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

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

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

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

JSON প্রতিনিধিত্ব 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceList": {
    object (AudienceList)
  },
  "rowCount": integer
}
ক্ষেত্র
audience Rows[]

object ( AudienceRow )

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

audience List

object ( AudienceList )

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

row Count

integer

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

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

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

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

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

শ্রোতা সারি

শ্রোতা ব্যবহারকারী সারির জন্য মাত্রা মান বৈশিষ্ট্য।

JSON প্রতিনিধিত্ব 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
ক্ষেত্র
dimension Values[]

object ( AudienceDimensionValue )

একজন দর্শক ব্যবহারকারীর জন্য প্রতিটি মাত্রা মান বৈশিষ্ট্য। অনুরোধ করা প্রতিটি মাত্রা কলামের জন্য একটি মাত্রা মান যোগ করা হবে।

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

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

JSON প্রতিনিধিত্ব 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্র one_value । এক ধরনের মাত্রা মান। one_value নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
value

string

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