Method: advertisers.insertionOrders.list

একটি বিজ্ঞাপনদাতা মধ্যে সন্নিবেশ আদেশ তালিকা.

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

HTTP অনুরোধ

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

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

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

পরামিতি
advertiserId

string ( int64 format)

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

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

পরামিতি
pageSize

integer

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

pageToken

string

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

orderBy

string

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

  • "displayName" (ডিফল্ট)
  • "সত্তার অবস্থা"
  • "আপডেটের সময়"

ডিফল্ট সাজানোর ক্রম ক্রমবর্ধমান। একটি ক্ষেত্রের জন্য অবরোহ ক্রম নির্দিষ্ট করতে, ক্ষেত্রের নামের সাথে একটি প্রত্যয় "ডেস্ক" যোগ করা উচিত। উদাহরণ: 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" চেয়ে বেশি বা সমান আপডেট সময়ের সাথে সমস্ত সন্নিবেশ আদেশ

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

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