Method: advertisers.adGroupAds.list

বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপনগুলির তালিকা দেখায়।

HTTP অনুরোধ

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

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

পথের পরামিতি

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

string ( int64 format)

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

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

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

integer

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

pageToken

string

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

orderBy

string

ঐচ্ছিক। যে ফিল্ডের ভিত্তিতে তালিকাটি সাজানো হবে। গ্রহণযোগ্য মানগুলো হলো:

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

ডিফল্ট সর্টিং অর্ডার হলো আরোহী। কোনো ফিল্ডের জন্য অবরোহী ক্রম নির্দিষ্ট করতে হলে, ফিল্ডের নামের শেষে 'desc' সাফিক্সটি যোগ করতে হবে। উদাহরণ: displayName desc ।

filter

string

ঐচ্ছিক। এর মাধ্যমে বিজ্ঞাপন গ্রুপের বিজ্ঞাপন ফিল্ড অনুযায়ী ফিল্টার করা যায়।

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

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

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

  • adGroupId
  • displayName
  • entityStatus
  • adGroupAdId

উদাহরণ:

  • একটি অ্যাড গ্রুপের অধীনে থাকা সমস্ত বিজ্ঞাপন: adGroupId="1234"
  • ENTITY_STATUS_ACTIVE অথবা ENTITY_STATUS_PAUSED entityStatus যুক্ত একটি অ্যাড গ্রুপের সমস্ত বিজ্ঞাপন : (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND adGroupId="12345"

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

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

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

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

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

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

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

object ( AdGroupAd )

বিজ্ঞাপনগুলোর তালিকা।

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

nextPageToken

string

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

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

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

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

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