Method: advertisers.list

বর্তমান ব্যবহারকারীর কাছে অ্যাক্সেসযোগ্য বিজ্ঞাপনদাতাদের তালিকা করে।

অর্ডারটি orderBy প্যারামিটার দ্বারা সংজ্ঞায়িত করা হয়।

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

HTTP অনুরোধ

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

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

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

পরামিতি
partnerId

string ( int64 format)

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

pageSize

integer

অনুরোধ পৃষ্ঠা আকার. 1 থেকে 200 মধ্যে হতে হবে। অনির্দিষ্ট হলে 100 ডিফল্ট হবে।

pageToken

string

একটি টোকেন ফলাফলের একটি পৃষ্ঠা চিহ্নিত করে যা সার্ভারের ফিরে আসা উচিত। সাধারণত, এটি হল nextPageToken মান যা পূর্ববর্তী কল থেকে advertisers.list পদ্ধতিতে ফেরত দেওয়া হয়। নির্দিষ্ট না থাকলে, ফলাফলের প্রথম পৃষ্ঠাটি ফেরত দেওয়া হবে।

orderBy

string

ক্ষেত্র যা দ্বারা তালিকা বাছাই. গ্রহণযোগ্য মান হল:

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

ডিফল্ট সাজানোর ক্রম ক্রমবর্ধমান। একটি ক্ষেত্রের জন্য অবরোহ ক্রম নির্দিষ্ট করতে, ক্ষেত্রের নামের সাথে একটি প্রত্যয় "ডেস্ক" যোগ করা উচিত। উদাহরণস্বরূপ, 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" এর চেয়ে কম বা সমান আপডেট টাইম সহ সমস্ত বিজ্ঞাপনদাতাদের
  • 2020-11-04T18:54:47Z (ISO 8601-এর ফর্ম্যাট): updateTime>="2020-11-04T18:54:47Z" এর থেকে বেশি বা সমান আপডেট সময় সহ সমস্ত বিজ্ঞাপনদাতাদের

এই ক্ষেত্রের দৈর্ঘ্য 500 অক্ষরের বেশি হওয়া উচিত নয়।

আরো তথ্যের জন্য আমাদের ফিল্টার 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 ওভারভিউ দেখুন।