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

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

বিন্যাস: properties/{property}/audiences/{audience}

audienceDisplayName

string

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

dimensions[]

object ( AudienceDimension )

প্রয়োজন। মাত্রা অনুরোধ করা হয়েছে এবং ক্যোয়ারী প্রতিক্রিয়া প্রদর্শিত.

creationQuotaTokensCharged

integer

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

state

enum ( State )

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

beginCreatingTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময় শ্রোতা তালিকা তৈরি করা হয়েছিল এবং দর্শক তালিকা CREATING অবস্থা শুরু হয়েছিল।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

rowCount

integer

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

errorMessage

string

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

percentageCompleted

number

শুধুমাত্র আউটপুট। এই দর্শক রপ্তানির জন্য শতকরা হার 0 থেকে 100 এর মধ্যে।

recurringAudienceList

string

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

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

webhookNotification

object ( WebhookNotification )

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

এক বা দুটি পোস্ট অনুরোধ ওয়েবহুকে পাঠানো হবে। প্রথম POST অনুরোধটি অবিলম্বে পাঠানো হবে যাতে নতুন তৈরি দর্শকদের তালিকা তৈরি করা অবস্থায় দেখানো হয়। শ্রোতা তালিকা তৈরি করা শেষ হওয়ার পরে দ্বিতীয় POST অনুরোধ পাঠানো হবে (হয় সক্রিয় বা ব্যর্থ অবস্থা)।

অভিন্ন শ্রোতা তালিকা দ্রুত ধারাবাহিকভাবে অনুরোধ করা হলে, দ্বিতীয় এবং পরবর্তী শ্রোতা তালিকা ক্যাশে থেকে পরিবেশন করা যেতে পারে। সেক্ষেত্রে, দর্শক তালিকা তৈরি করার পদ্ধতিটি একটি দর্শক তালিকা ইতিমধ্যেই সক্রিয় করতে পারে। এই পরিস্থিতিতে, শুধুমাত্র একটি POST অনুরোধ ওয়েবহুকে পাঠানো হবে।

অবস্থা

শ্রোতা তালিকা বর্তমানে এই রাজ্যে বিদ্যমান।

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

পদ্ধতি

create

 পরে পুনরুদ্ধারের জন্য একটি শ্রোতা তালিকা তৈরি করে।

exportSheet

 একটি Google পত্রক ব্যবহারকারীদের একটি দর্শক তালিকা রপ্তানি করে৷

get

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

list

 একটি সম্পত্তির জন্য সমস্ত শ্রোতা তালিকা তালিকা.

query

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