Method: advertisers.creatives.list

একজন বিজ্ঞাপনদাতার মধ্যে ক্রিয়েটিভের তালিকা করে।

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

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/creatives

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

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

পরামিতি
advertiserId

string ( int64 format)

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

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

পরামিতি
pageSize

integer

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

pageToken

string

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

orderBy

string

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

  • creativeId (ডিফল্ট)
  • createTime
  • mediaDuration
  • dimensions (প্রথমে প্রস্থ অনুসারে, তারপর উচ্চতা অনুসারে)

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

filter

string

সৃজনশীল ক্ষেত্র দ্বারা ফিল্টার করার অনুমতি দেয়।

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

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক সীমাবদ্ধতা নিয়ে গঠিত।
  • সীমাবদ্ধতা AND বা OR যৌক্তিক অপারেটর দ্বারা একত্রিত করা যেতে পারে। বিধিনিষেধের একটি ক্রম অন্তর্নিহিতভাবে AND ব্যবহার করে।
  • একটি সীমাবদ্ধতার ফর্ম আছে {field} {operator} {value} ।
  • lineItemIds ক্ষেত্রে অবশ্যই HAS (:) অপারেটর ব্যবহার করতে হবে।
  • updateTime ক্ষেত্রটি অবশ্যই GREATER THAN OR EQUAL TO (>=) বা LESS THAN OR EQUAL TO (<=) অপারেটর ব্যবহার করতে হবে।
  • অন্য সব ক্ষেত্র অবশ্যই EQUALS (=) অপারেটর ব্যবহার করতে হবে।
  • entityStatus , minDuration , maxDuration , updateTime , এবং dynamic ফিল্ডের জন্য সর্বাধিক একটি সীমাবদ্ধতা থাকতে পারে৷

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

  • approvalStatus
  • creativeId
  • creativeType
  • dimensions ( {width}x{height} আকারে ইনপুট)
  • dynamic
  • entityStatus
  • exchangeReviewStatus ( {exchange}-{reviewStatus} আকারে ইনপুট)
  • lineItemIds
  • maxDuration ( {duration}s আকারে ইনপুট। শুধুমাত্র সেকেন্ড সমর্থিত)
  • minDuration ( {duration}s আকারে ইনপুট। শুধুমাত্র সেকেন্ড সমর্থিত)
  • updateTime (ISO 8601 ফর্ম্যাটে ইনপুট, বা YYYY-MM-DDTHH:MM:SSZ )

মন্তব্য:

  • updateTime এর জন্য, একটি সৃজনশীল সম্পদের ক্ষেত্রের মান একটি ক্রিয়েটিভ আপডেট করার শেষ সময় প্রতিফলিত করে, যার মধ্যে সিস্টেম দ্বারা তৈরি করা আপডেটগুলি (যেমন সৃজনশীল পর্যালোচনা আপডেট) অন্তর্ভুক্ত থাকে।

উদাহরণ:

  • সমস্ত নেটিভ ক্রিয়েটিভ: creativeType="CREATIVE_TYPE_NATIVE"
  • 300x400 বা 50x100 মাত্রা সহ সমস্ত সক্রিয় সৃজনশীল: entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400" OR dimensions="50x100")
  • সমস্ত গতিশীল ক্রিয়েটিভ যা AdX বা AppNexus দ্বারা অনুমোদিত, ন্যূনতম 5 সেকেন্ড এবং 200ms এর সময়কাল সহ dynamic="true" AND minDuration="5.2s" AND (exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED" OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")
  • সমস্ত ভিডিও ক্রিয়েটিভ যা লাইন আইটেম আইডি 1 বা 2 এর সাথে যুক্ত: creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2)
  • একাধিক ক্রিয়েটিভ আইডি দ্বারা সৃজনশীল খুঁজুন: creativeId=1 OR creativeId=2
  • 2020-11-04T18:54:47Z (ISO 8601 এর ফরম্যাট): updateTime>="2020-11-04T18:54:47Z" চেয়ে বেশি বা সমান আপডেটের সময় সহ সমস্ত ক্রিয়েটিভ

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

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

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

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

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

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

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

object ( Creative )

সৃজনশীলদের তালিকা।

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

nextPageToken

string

ফলাফলের পরবর্তী পৃষ্ঠা পুনরুদ্ধার করার জন্য একটি টোকেন। ফলাফলের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে ListCreativesRequest পদ্ধতিতে পরবর্তী কলে pageToken ক্ষেত্রে এই মানটি পাস করুন। যদি এই ক্ষেত্রটি শূন্য হয়, তাহলে এর মানে হল এটি শেষ পৃষ্ঠা।

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

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

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

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