REST Resource: properties.audienceExports

উৎস: অডিয়েন্সএক্সপোর্ট

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

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

string

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

ফর্ম্যাট: properties/{property}/audienceExports/{audienceExport}

audience

string

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

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

audienceDisplayName

string

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

dimensions[]

object ( AudienceDimension )

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

creationQuotaTokensCharged

integer

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

state

enum ( State )

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

beginCreatingTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে audienceExports.create কল করা হয়েছিল এবং AudienceExport-টি 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

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

errorMessage

string

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

percentageCompleted

number

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

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

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

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

string

ঐচ্ছিক। ডাইমেনশনটির এপিআই নাম। ডাইমেনশন নামগুলোর তালিকার জন্য এপিআই ডাইমেনশনস দেখুন।

রাজ্য

AudienceExport বর্তমানে এই অবস্থায় রয়েছে।

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

পদ্ধতি

create

 পরবর্তীতে ব্যবহারের জন্য একটি অডিয়েন্স এক্সপোর্ট তৈরি করে।

get

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

list

 একটি প্রপার্টির জন্য সমস্ত অডিয়েন্স এক্সপোর্ট তালিকাভুক্ত করে।

query

 ব্যবহারকারীদের একটি অডিয়েন্স এক্সপোর্ট পুনরুদ্ধার করে।