Method: advertisers.adGroups.list

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

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/adGroups

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

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

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

string (int64 format)

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

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

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

integer

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

string

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

string

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

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

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

string

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

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

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক বিধিনিষেধ নিয়ে তৈরি হয়।
  • AND এবং OR-এর মাধ্যমে বিধিনিষেধ একত্রিত করা যেতে পারে। বিধিনিষেধের একটি ক্রম অন্তর্নিহিতভাবে AND ব্যবহার করে।
  • {field} {operator} {value}-এর ফর্মের উপর বিধিনিষেধ আছে।
  • সব ফিল্ডে অবশ্যই EQUALS (=) অপারেটর ব্যবহার করতে হবে।

যেসব প্রপার্টিতে কাজ করে:

  • adGroupId
  • displayName
  • entityStatus
  • lineItemId
  • adGroupFormat

উদাহরণ:

  • লাইন আইটেমের অধীনে থাকা সব বিজ্ঞাপন গ্রুপ: lineItemId="1234"
  • কোনও বিজ্ঞাপনদাতার অধীনে থাকা সব ENTITY_STATUS_ACTIVE বা ENTITY_STATUS_PAUSED AD_GROUP_FORMAT_IN_STREAM বিজ্ঞাপন গ্রুপ: (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND adGroupFormat="AD_GROUP_FORMAT_IN_STREAM"

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

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

অনুরোধের বডি

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

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

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

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

object (AdGroup)

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

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

string

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

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

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

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

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