Method: advertisers.campaigns.list

একটি বিজ্ঞাপনদাতা প্রচারাভিযান তালিকা.

অর্ডারটি orderBy প্যারামিটার দ্বারা সংজ্ঞায়িত করা হয়। যদি entityStatus দ্বারা একটি filter নির্দিষ্ট করা না থাকে, তাহলে ENTITY_STATUS_ARCHIVED সহ প্রচারাভিযান ফলাফলে অন্তর্ভুক্ত করা হবে না।

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v1beta2/advertisers/{advertiserId}/campaigns

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

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

পরামিতি
advertiserId

string ( int64 format)

প্রচারাভিযানের তালিকা করতে বিজ্ঞাপনদাতার আইডি।

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

পরামিতি
pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

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

filter

string

প্রচারাভিযানের বৈশিষ্ট্য দ্বারা ফিল্টার করার অনুমতি দেয়।

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

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক সীমাবদ্ধতা নিয়ে গঠিত।
  • সীমাবদ্ধতা AND বা OR যৌক্তিক অপারেটর দ্বারা একত্রিত করা যেতে পারে। বিধিনিষেধের একটি ক্রম অন্তর্নিহিতভাবে AND ব্যবহার করে।
  • একটি সীমাবদ্ধতার ফর্ম আছে {field} {operator} {value} ।
  • updateTime ব্যবহৃত অপারেটরটি অবশ্যই GREATER THAN OR EQUAL TO (>=) হতে হবে বা LESS THAN OR EQUAL TO (<=) ।
  • অপারেটর অবশ্যই EQUALS (=) হতে হবে।
  • সমর্থিত ক্ষেত্র:
    • campaignId
    • displayName
    • entityStatus
    • updateTime (ISO 8601 ফর্ম্যাটে ইনপুট বা YYYY-MM-DDTHH:MM:SSZ)

উদাহরণ:

  • একটি বিজ্ঞাপনদাতার অধীনে সমস্ত ENTITY_STATUS_ACTIVE বা ENTITY_STATUS_PAUSED প্রচারণা: (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED")
  • 2020-11-04T18:54:47Z (format of ISO 8601) এর চেয়ে কম বা সমান আপডেট টাইম সহ সমস্ত প্রচারাভিযান : updateTime<="2020-11-04T18:54:47Z"
  • 2020-11-04T18:54:47Z (format of ISO 8601) এর চেয়ে বেশি বা সমান আপডেট সময় সহ সমস্ত প্রচারাভিযান : updateTime>="2020-11-04T18:54:47Z"

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

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

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

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

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

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

object ( Campaign )

প্রচারণার তালিকা।

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

nextPageToken

string

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

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

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

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

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