Method: advertisers.reachForecast.retrievePlannableUserLists

পূর্বাভাসের জন্য উপলব্ধ প্রথম ও তৃতীয় পক্ষের ব্যবহারকারীদের তালিকা পুনরুদ্ধার করে।

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableUserLists

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

পথের পরামিতি

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

string ( int64 format)

পরিকল্পনাযোগ্য ব্যবহারকারীর তালিকা পুনরুদ্ধার করার জন্য বিজ্ঞাপনদাতার আইডি প্রয়োজন।

কোয়েরি প্যারামিটার

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

integer

ঐচ্ছিক। অনুরোধকৃত পৃষ্ঠার আকার। অবশ্যই 1 থেকে 5000 এর মধ্যে হতে হবে। নির্দিষ্ট না করা হলে ডিফল্ট হিসেবে 5000 ব্যবহৃত হবে।

pageToken

string

ঐচ্ছিক। একটি টোকেন যা ফলাফলের সেই পৃষ্ঠাটিকে শনাক্ত করে, যা সার্ভার ফেরত দেবে। সাধারণত, এটি হলো reachForecast.retrievePlannableUserLists মেথডের পূর্ববর্তী কল থেকে ফেরত আসা nextPageToken এর মান। যদি এটি নির্দিষ্ট না করা হয়, তাহলে ফলাফলের প্রথম পৃষ্ঠাটি ফেরত দেওয়া হবে।

filter

string

ঐচ্ছিক। এর মাধ্যমে পরিকল্পনাযোগ্য ব্যবহারকারী তালিকার বৈশিষ্ট্য অনুযায়ী ফিল্টার করা যায়।

সমর্থিত সিনট্যাক্স:

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক সীমাবদ্ধতা দ্বারা গঠিত হয়।
  • AND বা OR লজিক্যাল অপারেটরের মাধ্যমে বিধিনিষেধগুলোকে একত্রিত করা যায়।
  • একটি বিধিনিষেধের গঠন হলো {field} {operator} {value} ।
  • displayName ফিল্ডে অবশ্যই HAS (:) অপারেটর ব্যবহার করতে হবে।
  • অন্যান্য সকল ফিল্ডে অবশ্যই EQUALS (=) অপারেটর ব্যবহার করতে হবে।

সমর্থিত ক্ষেত্রসমূহ:

  • plannableStatus
  • displayName
  • userListType
  • name

উদাহরণ:

  • সকল পরিকল্পনাযোগ্য ব্যবহারকারী তালিকা: plannableStatus="PLANNABLE"
  • পরিকল্পনাযোগ্য ব্যবহারকারী তালিকা যাদের প্রদর্শিত নামে "Shopping" রয়েছে: plannableStatus="PLANNABLE" AND displayName:"Shopping"
  • প্রথম পক্ষের ব্যবহারকারীর তালিকা: userListType="FIRST_PARTY"

এই ফিল্ডটির দৈর্ঘ্য ৫০০ অক্ষরের বেশি হওয়া উচিত নয়।

আরও তথ্যের জন্য আমাদের ফিল্টার LIST অনুরোধ নির্দেশিকা দেখুন।

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

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

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

reachForecast.retrievePlannableUserLists-এর প্রতিক্রিয়া।

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

JSON উপস্থাপনা 
{
  "plannableUserLists": [
    {
      object (PlannableUserList)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
plannableUserLists[]

object ( PlannableUserList )

শুধুমাত্র আউটপুট। পরিকল্পনাযোগ্য ব্যবহারকারী তালিকাগুলোর তালিকা।

nextPageToken

string

শুধুমাত্র আউটপুট। ফলাফলের পরবর্তী পৃষ্ঠাটি পাওয়ার জন্য একটি টোকেন।

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

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/display-video

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

পরিকল্পনাযোগ্য ব্যবহারকারীর তালিকা

রিচ পূর্বাভাসের জন্য ব্যবহৃত একটি পরিকল্পনাযোগ্য ব্যবহারকারী তালিকা।

JSON উপস্থাপনা 
{
  "displayName": string,
  "userListType": enum (UserListType),
  "name": string,
  "plannableStatus": enum (PlannableStatus)
}
ক্ষেত্র
displayName

string

শুধুমাত্র আউটপুট। ব্যবহারকারী তালিকার প্রদর্শিত নাম।

userListType

enum ( UserListType )

শুধুমাত্র আউটপুট। ব্যবহারকারী তালিকার ধরণ।

name

string

শুধুমাত্র আউটপুট। ব্যবহারকারী তালিকা শনাক্তকারী রিসোর্সের নাম।

ফর্ম্যাট: advertisers/{advertiserId}/userLists/{user_list_id}

plannableStatus

enum ( PlannableStatus )

শুধুমাত্র আউটপুট। ব্যবহারকারী তালিকার পরিকল্পনাযোগ্যতার অবস্থা।

ব্যবহারকারীর তালিকার ধরন

ব্যবহারকারী তালিকার প্রকারভেদ।

এনাম
USER_LIST_TYPE_UNSPECIFIED অনির্দিষ্ট ব্যবহারকারী তালিকার ধরণ।
FIRST_PARTY প্রথম পক্ষের ব্যবহারকারীদের একটি তালিকা।
THIRD_PARTY তৃতীয় পক্ষের ব্যবহারকারীদের তালিকা।

পরিকল্পনাযোগ্য অবস্থা

একটি তালিকা পরিকল্পনাযোগ্য কি না, তা নির্দেশকারী অবস্থা।

এনাম
PLANNABLE_STATUS_UNSPECIFIED অনির্দিষ্ট পরিকল্পনাযোগ্যতার অবস্থা।
PLANNABLE ব্যবহারকারী তালিকাটি পরিকল্পনাযোগ্য।
UNPLANNABLE ব্যবহারকারী তালিকাটি পরিকল্পনাযোগ্য নয়।