Method: advertisers.creatives.list

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

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

HTTP অনুরোধ

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

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

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

পরামিতি
advertiserId

string ( int64 format)

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

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

পরামিতি
pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

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

filter

string

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

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

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক সীমাবদ্ধতা নিয়ে গঠিত।
  • একই ক্ষেত্রের জন্য সীমাবদ্ধতা অবশ্যই OR দ্বারা মিলিত হতে হবে।
  • বিভিন্ন ক্ষেত্রের জন্য সীমাবদ্ধতা অবশ্যই AND দ্বারা মিলিত হতে হবে।
  • ( এবং ) এর মধ্যে শুধুমাত্র একই ক্ষেত্রের জন্য OR দ্বারা মিলিত সীমাবদ্ধতা থাকতে পারে।
  • একটি সীমাবদ্ধতার ফর্ম আছে {field} {operator} {value} ।
  • নিম্নলিখিত ক্ষেত্রগুলির জন্য অপারেটরকে অবশ্যই EQUALS (=) হতে হবে:
    • entityStatus
    • creativeType
    • dimensions
    • minDuration
    • maxDuration
    • approvalStatus
    • exchangeReviewStatus
    • dynamic
    • creativeId
  • নিম্নলিখিত ক্ষেত্রের জন্য অপারেটর অবশ্যই HAS (:) হতে হবে:
    • lineItemIds
  • নিম্নলিখিত ক্ষেত্রগুলির জন্য অপারেটরকে অবশ্যই GREATER THAN OR EQUAL TO (>=) বা LESS THAN OR EQUAL TO (<=) হতে হবে:
    • updateTime (ISO 8601 ফর্ম্যাটে ইনপুট বা YYYY-MM-DDTHH:MM:SSZ)
  • entityStatus , minDuration , maxDuration , updateTime এবং dynamic এর জন্য সর্বাধিক একটি সীমাবদ্ধতা থাকতে পারে৷
  • dimensions জন্য, মানটি "{width}x{height}" আকারে।
  • exchangeReviewStatus এর জন্য, মানটি {exchange}-{reviewStatus} আকারে।
  • minDuration এবং maxDuration এর জন্য, মানটি "{duration}s" আকারে। মিলিসেকেন্ড গ্রানুলারিটির সাথে শুধুমাত্র সেকেন্ড সমর্থিত।
  • updateTime এর জন্য, একটি সৃজনশীল সম্পদের ক্ষেত্রের মান শেষবার একটি সৃজনশীল আপডেট করা হয়েছে তা প্রতিফলিত করে, যার মধ্যে সিস্টেম দ্বারা তৈরি করা আপডেটগুলি অন্তর্ভুক্ত থাকে (যেমন সৃজনশীল পর্যালোচনা আপডেট)।
  • একাধিক সম্ভাব্য লাইন আইটেম আইডিগুলির বিরুদ্ধে অনুসন্ধান করার জন্য একাধিক lineItemIds সীমাবদ্ধতা থাকতে পারে৷
  • একাধিক সম্ভাব্য ক্রিয়েটিভ আইডির বিরুদ্ধে অনুসন্ধান করার জন্য একাধিক creativeId সীমাবদ্ধতা থাকতে পারে।

উদাহরণ:

  • সমস্ত নেটিভ ক্রিয়েটিভ: 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 (format of ISO 8601) এর চেয়ে বেশি বা সমান আপডেট সময় সহ সমস্ত ক্রিয়েটিভ : updateTime>="2020-11-04T18:54:47Z" এই ক্ষেত্রের দৈর্ঘ্য আর হওয়া উচিত নয় 500টিরও বেশি অক্ষর।

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

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

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

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

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

object ( Creative )

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

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

nextPageToken

string

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

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

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

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

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