Method: advertisers.insertionOrders.list

বিজ্ঞাপনদাতার ইনসার্শন অর্ডার তালিকাভুক্ত করে।

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

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/insertionOrders

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

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

প্যারামিটারগুলি
advertiserId

string (int64 format)

প্রয়োজনীয়। বিজ্ঞাপনদাতার আইডি যার জন্য ইনসার্শন অর্ডার তালিকাভুক্ত করতে হবে।

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

প্যারামিটারগুলি
pageSize

integer

অনুরোধ করা পৃষ্ঠার সাইজ। 1 থেকে 100-এর মধ্যে হতে হবে। উল্লেখ না করা থাকলে, ডিফল্ট হিসেবে 100 হবে। ভুল ভ্যালু উল্লেখ করা হলে, ত্রুটি কোড INVALID_ARGUMENT দেখায়।
pageToken

string

সার্ভার যে ফলাফল ফেরত পাঠাবে তার পৃষ্ঠা শনাক্ত করার টোকেন। সাধারণত, এটি হল nextPageToken-এর ভ্যালু যা insertionOrders.list পদ্ধতিতে আগের কল থেকে ফেরত এসেছে। উল্লেখ করা না থাকলে, ফলাফলের প্রথম পৃষ্ঠা দেখানো হবে।
orderBy

string

যে ফিল্ড অনুযায়ী তালিকা সাজানো হবে। গ্রহণযোগ্য ভ্যালু হল:

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

ক্রমানুসারে সাজানোর ডিফল্ট সেটিংস হল ছোট থেকে বড়। কোনও ফিল্ডের জন্য নিম্নক্রম নির্দিষ্ট করতে, ফিল্ডের নামের শেষে "desc" যোগ করতে হবে। উদাহরণ: 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)

উদাহরণ:

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

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

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

অনুরোধের বডি

অনুরোধের বডি ফাঁকা থাকতে হবে।

প্রতিক্রিয়ার বডি

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

JSON উপস্থাপনা 
{
  "insertionOrders": [
    {
      object (InsertionOrder)
    }
  ],
  "nextPageToken": string
}
ফিল্ড
insertionOrders[]

object (InsertionOrder)

ইনসার্শন অর্ডারের তালিকা।

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

string

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

অনুমোদনের স্কোপ

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

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

আরও তথ্যের জন্য, OAuth 2.0 Overview দেখুন।