Method: advertisers.creatives.list

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

orderBy প্যারামিটার দ্বারা ক্রম নির্ধারণ করা হয়। filter-এর entityStatus উল্লেখ করা না থাকলে, ENTITY_STATUS_ARCHIVED সহ ক্রিয়েটিভ ফলাফলে অন্তর্ভুক্ত করা হবে না।

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v5/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 (প্রথমে প্রস্থ অনুযায়ী, তারপর উচ্চতা অনুযায়ী সাজায়)

ক্রমানুসারে সাজানোর ডিফল্ট সেটিংস হল ছোট থেকে বড়। কোনও ফিল্ডের জন্য নিম্নক্রম নির্দিষ্ট করতে, ফিল্ডের নামের শেষে "desc" যোগ করতে হবে। উদাহরণ: 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"
  • ৩০০x৪০০ বা ৫০x১০০ ডাইমেনশন সহ সব অ্যাক্টিভ ক্রিয়েটিভ: entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400" OR dimensions="50x100")
  • AdX বা AppNexus দ্বারা অনুমোদিত সমস্ত ডাইনামিক ক্রিয়েটিভ, যার ন্যূনতম সময়কাল ৫ সেকেন্ড এবং ২০০ মিলি সেকেন্ড: dynamic="true" AND minDuration="5.2s" AND (exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED" OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")
  • লাইন আইটেম আইডি ১ বা ২-এর সাথে যুক্ত সব ভিডিও ক্রিয়েটিভ: 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"

এই ফিল্ডে ৫০০টির বেশি অক্ষর লেখা যাবে না।

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