REST Resource: properties.audienceLists

উৎস: অডিয়েন্সলিস্ট

অডিয়েন্স লিস্ট হলো তালিকাটি তৈরির সময় কোনো অডিয়েন্সে থাকা ব্যবহারকারীদের একটি তালিকা। একটি অডিয়েন্সের অধীনে বিভিন্ন দিনের জন্য একাধিক অডিয়েন্স লিস্ট তৈরি করা থাকতে পারে।

JSON উপস্থাপনা 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number,
  "recurringAudienceList": string,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। শনাক্তকারী। তৈরির সময় নির্ধারিত অডিয়েন্স লিস্ট রিসোর্সের নাম। এই রিসোর্স নামটি এই AudienceList শনাক্ত করে।

ফরম্যাট: properties/{property}/audienceLists/{audienceList}

audience

string

আবশ্যক। অডিয়েন্স রিসোর্স নেম। এই রিসোর্স নেমটি তালিকাভুক্ত অডিয়েন্সকে শনাক্ত করে এবং এটি অ্যানালিটিক্স ডেটা ও অ্যাডমিন এপিআই-এর মধ্যে শেয়ার করা হয়।

ফরম্যাট: properties/{property}/audiences/{audience}

audienceDisplayName

string

শুধুমাত্র আউটপুট। এই দর্শকগোষ্ঠীর জন্য বর্ণনামূলক প্রদর্শিত নাম। উদাহরণস্বরূপ, "ক্রেতাগণ"।

dimensions[]

object ( AudienceDimension )

প্রয়োজনীয়। কোয়েরি রেসপন্সে অনুরোধকৃত এবং প্রদর্শিত ডাইমেনশনসমূহ।

creationQuotaTokensCharged

integer

শুধুমাত্র আউটপুট। অডিয়েন্সলিস্ট তৈরির সময় চার্জ করা মোট কোটা টোকেন। যেহেতু এই টোকেন সংখ্যাটি CREATING অবস্থার কার্যকলাপের উপর ভিত্তি করে নির্ধারিত হয়, তাই কোনো অডিয়েন্সলিস্ট ACTIVE বা FAILED অবস্থায় প্রবেশ করলে এই চার্জ করা টোকেনের পরিমাণ স্থির হয়ে যাবে।

state

enum ( State )

শুধুমাত্র আউটপুট। এই AudienceList-টির বর্তমান অবস্থা।

beginCreatingTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে audienceLists.create কল করা হয়েছিল এবং AudienceList-টি CREATING অবস্থায় প্রবেশ করেছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

rowCount

integer

শুধুমাত্র আউটপুট। AudienceList ফলাফলের মোট সারির সংখ্যা।

errorMessage

string

শুধুমাত্র আউটপুট। অডিয়েন্স তালিকা তৈরির সময় ব্যর্থ হলে ত্রুটির বার্তাটি প্রদর্শিত হয়। এই ধরনের ব্যর্থতার একটি সাধারণ কারণ হলো কোটা শেষ হয়ে যাওয়া।

percentageCompleted

number

শুধুমাত্র আউটপুট। এই অডিয়েন্স এক্সপোর্টের জন্য সম্পন্ন হওয়া কাজের শতাংশ ০ থেকে ১০০-এর মধ্যে।

recurringAudienceList

string

শুধুমাত্র আউটপুট। যে পুনরাবৃত্ত দর্শক তালিকাটি এই দর্শক তালিকাটি তৈরি করেছে। পুনরাবৃত্ত দর্শক তালিকাগুলো প্রতিদিন নতুন দর্শক তালিকা তৈরি করে।

যদি অডিয়েন্স তালিকা সরাসরি তৈরি করা হয়, তবে সেগুলোর সাথে কোনো পুনরাবৃত্ত অডিয়েন্স তালিকা যুক্ত থাকবে না এবং এই ক্ষেত্রটি খালি থাকবে।

webhookNotification

object ( WebhookNotification )

ঐচ্ছিক। গুগল অ্যানালিটিক্স ডেটা এপিআই থেকে আপনার ওয়েবহুক সার্ভারে ওয়েবহুক নোটিফিকেশন পাঠানোর জন্য এটি কনফিগার করে। ওয়েবহুকের ব্যবহার ঐচ্ছিক। যদি এটি ব্যবহার না করা হয়, তাহলে একটি অডিয়েন্স লিস্ট কখন ব্যবহারের জন্য প্রস্তুত হবে তা নির্ধারণ করতে আপনাকে এই এপিআই পোল করতে হবে। ওয়েবহুক আপনার সার্ভারে নোটিফিকেশন পাঠাতে সাহায্য করে এবং পোল করার প্রয়োজনীয়তা এড়িয়ে যায়।

ওয়েবহুকে একটি অথবা দুটি POST রিকোয়েস্ট পাঠানো হবে। প্রথম POST রিকোয়েস্টটি নতুন তৈরি হওয়া অডিয়েন্স লিস্টটিকে তার CREATING অবস্থায় দেখানোর সাথে সাথেই পাঠানো হবে। অডিয়েন্স লিস্টটি তৈরি হওয়া সম্পূর্ণ হওয়ার পর (ACTIVE অথবা FAILED অবস্থায়) দ্বিতীয় POST রিকোয়েস্টটি পাঠানো হবে।

যদি পরপর একই অডিয়েন্স লিস্টের জন্য অনুরোধ করা হয়, তাহলে দ্বিতীয় ও পরবর্তী অডিয়েন্স লিস্টগুলো ক্যাশে থেকে সরবরাহ করা যেতে পারে। সেক্ষেত্রে, অডিয়েন্স লিস্ট ক্রিয়েট মেথডটি রিটার্ন করতে পারে যে অডিয়েন্স লিস্টটি ইতিমধ্যেই ACTIVE আছে। এই পরিস্থিতিতে, ওয়েবহুকে শুধুমাত্র একটি POST রিকোয়েস্ট পাঠানো হবে।

রাজ্য

AudienceList-টি বর্তমানে এই অবস্থায় রয়েছে।

এনাম
STATE_UNSPECIFIED অনির্দিষ্ট অবস্থা কখনো ব্যবহৃত হবে না।
CREATING অডিয়েন্সলিস্টটি বর্তমানে তৈরি হচ্ছে এবং ভবিষ্যতে উপলব্ধ হবে। audienceLists.create কল করার ঠিক পরেই এটি তৈরি হয়।
ACTIVE অডিয়েন্সলিস্টটি সম্পূর্ণরূপে তৈরি এবং কোয়েরি করার জন্য প্রস্তুত। একটি অডিয়েন্সলিস্ট কোনো অনুরোধের মাধ্যমে অ্যাসিঙ্ক্রোনাসভাবে সক্রিয় অবস্থায় আপডেট করা হয়; এটি প্রাথমিক ক্রিয়েট কলের কিছু সময় (উদাহরণস্বরূপ ১৫ মিনিট) পরে ঘটে।
FAILED অডিয়েন্সলিস্টটি তৈরি করা সম্ভব হয়নি। পুনরায় অনুরোধ করলে তা সফল হতে পারে।

পদ্ধতি

create

 পরবর্তীতে ব্যবহারের জন্য একটি দর্শক তালিকা তৈরি করে।

get

 একটি নির্দিষ্ট দর্শক তালিকার কনফিগারেশন মেটাডেটা সংগ্রহ করে।

list

 একটি প্রপার্টির সমস্ত অডিয়েন্স তালিকা দেখায়।

query

 ব্যবহারকারীদের একটি দর্শক তালিকা পুনরুদ্ধার করে।