Method: advertisers.list

বর্তমান ব্যবহারকারীর অ্যাক্সেস আছে এমন বিজ্ঞাপনদাতাদের তালিকা দেখায়।

orderBy প্যারামিটার দ্বারা ক্রম নির্ধারণ করা হয়।

একটিমাত্র partnerId প্রয়োজন। ক্রস-পার্টনার লিস্টিং কাজ করে না।

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v5/advertisers

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

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

প্যারামিটারগুলি
partnerId

string (int64 format)

প্রয়োজনীয়। ফেচ করা বিজ্ঞাপনদাতাদের যে পার্টনারের সাথে যুক্ত হতে হবে তার আইডি। সিস্টেমটি একবারে শুধুমাত্র একজন পার্টনারের জন্য বিজ্ঞাপনদাতাদের তালিকাভুক্ত করতে পারে।
pageSize

integer

অনুরোধ করা পৃষ্ঠার সাইজ। 1 থেকে 200-এর মধ্যে হতে হবে। উল্লেখ না করা থাকলে, ডিফল্ট হিসেবে 100 হবে।
pageToken

string

সার্ভার যে ফলাফল ফেরত পাঠাবে তার পৃষ্ঠা শনাক্ত করার টোকেন। সাধারণত, এটি হল nextPageToken-এর ভ্যালু যা advertisers.list পদ্ধতিতে আগের কল থেকে ফেরত এসেছে। উল্লেখ করা না থাকলে, ফলাফলের প্রথম পৃষ্ঠা দেখানো হবে।
orderBy

string

যে ফিল্ড অনুযায়ী তালিকা সাজানো হবে। গ্রহণযোগ্য ভ্যালু হল:

  • advertiserId (ডিফল্ট)
  • displayName
  • entityStatus
  • updateTime

ক্রমানুসারে সাজানোর ডিফল্ট সেটিংস হল ছোট থেকে বড়। কোনও ফিল্ডের জন্য নিম্নক্রম নির্দিষ্ট করতে, ফিল্ডের নামের শেষে "desc" যোগ করতে হবে। যেমন, displayName desc
filter

string

বিজ্ঞাপনদাতার ফিল্ড অনুযায়ী ফিল্টার করার অনুমতি দেয়।

কাজ করে এমন সিনট্যাক্স:

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক বিধিনিষেধ নিয়ে তৈরি হয়।
  • AND বা OR লজিক্যাল অপারেটর ব্যবহার করে বিধিনিষেধ একত্রিত করা যেতে পারে।
  • {field} {operator} {value}-এর ফর্মের উপর বিধিনিষেধ আছে।
  • updateTime ফিল্ডে অবশ্যই GREATER THAN OR EQUAL TO (>=) বা LESS THAN OR EQUAL TO (<=) অপারেটর ব্যবহার করতে হবে।
  • অন্য সব ফিল্ডে অবশ্যই EQUALS (=) অপারেটর ব্যবহার করতে হবে।

যেসব ফিল্ডে কাজ করে:

  • advertiserId
  • displayName
  • entityStatus
  • updateTime (ISO 8601 ফর্ম্যাটে ইনপুট, অথবা YYYY-MM-DDTHH:MM:SSZ)

উদাহরণ:

  • পার্টনারের অধীনে থাকা সব অ্যাক্টিভ বিজ্ঞাপনদাতা: entityStatus="ENTITY_STATUS_ACTIVE"
  • সব বিজ্ঞাপনদাতা যাদের আপডেট করার সময় 2020-11-04T18:54:47Z (ISO 8601 ফর্ম্যাট)-এর থেকে কম বা সমান: updateTime<="2020-11-04T18:54:47Z"
  • ২০২০-১১-০৪T১৮:৫৪:৪৭Z (ISO 8601 ফর্ম্যাট) সময়ের পরে বা সেই সময়ে আপডেট করা সব বিজ্ঞাপনদাতা: updateTime>="2020-11-04T18:54:47Z"

এই ফিল্ডে ৫০০টির বেশি অক্ষর লেখা যাবে না।

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

অনুরোধের বডি

অনুরোধের বডি ফাঁকা থাকতে হবে।

প্রতিক্রিয়ার বডি

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

JSON উপস্থাপনা 
{
  "advertisers": [
    {
      object (Advertiser)
    }
  ],
  "nextPageToken": string
}
ফিল্ড
advertisers[]

object (Advertiser)

বিজ্ঞাপনদাতার তালিকা।

খালি থাকলে এই তালিকাটি অনুপস্থিত থাকবে।
nextPageToken

string

পরবর্তী পৃষ্ঠার ফলাফল পাওয়ার জন্য টোকেন। পরবর্তী পৃষ্ঠার ফলাফল পেতে advertisers.list পদ্ধতিতে পরবর্তী কলে pageToken ফিল্ডে এই ভ্যালু পাস করুন।

অনুমোদনের স্কোপ

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

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

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