Method: advertisers.youtubeAdGroups.list

ইউটিউব বিজ্ঞাপন গোষ্ঠী তালিকাভুক্ত করে।

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/youtubeAdGroups

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

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

পরামিতি
advertiserId

string ( int64 format)

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

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

পরামিতি
pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

ডিফল্ট সাজানোর ক্রম ক্রমবর্ধমান। একটি ক্ষেত্রের জন্য অবরোহ ক্রম নির্দিষ্ট করতে, ক্ষেত্রের নামের সাথে একটি প্রত্যয় "ডেস্ক" যোগ করা উচিত। উদাহরণ: displayName desc ।

filter

string

কাস্টম YouTube বিজ্ঞাপন গোষ্ঠী ক্ষেত্র দ্বারা ফিল্টার করার অনুমতি দেয়।

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

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

সমর্থিত বৈশিষ্ট্য:

  • adGroupId
  • displayName
  • entityStatus
  • lineItemId
  • adGroupFormat

উদাহরণ:

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

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

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

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

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

JSON প্রতিনিধিত্ব
{
  "youtubeAdGroups": [
    {
      object (YoutubeAdGroup)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
youtubeAdGroups[]

object ( YoutubeAdGroup )

বিজ্ঞাপন গোষ্ঠীর তালিকা।

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

nextPageToken

string

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

অনুমোদনের সুযোগ

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

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

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।