Method: advertisers.adGroups.list

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

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v3/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

ডিফল্ট সাজানোর ক্রম ক্রমবর্ধমান। একটি ক্ষেত্রের জন্য অবরোহ ক্রম নির্দিষ্ট করতে, ক্ষেত্রের নামের সাথে একটি প্রত্যয় "ডেস্ক" যোগ করা উচিত। উদাহরণ: 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"

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

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