Method: advertisers.lineItems.list

একটি বিজ্ঞাপনদাতা লাইন আইটেম তালিকা.

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

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems

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

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

পরামিতি
advertiserId

string ( int64 format)

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

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

পরামিতি
pageSize

integer

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

pageToken

string

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

orderBy

string

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

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

ডিফল্ট সাজানোর ক্রম ক্রমবর্ধমান। একটি ক্ষেত্রের জন্য অবরোহ ক্রম নির্দিষ্ট করতে, ক্ষেত্রের নামের সাথে একটি প্রত্যয় "ডেস্ক" যোগ করা উচিত। উদাহরণ: 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
  • insertionOrderId
  • lineItemId
  • lineItemType
  • updateTime (ISO 8601 ফর্ম্যাটে ইনপুট, বা YYYY-MM-DDTHH:MM:SSZ )

উদাহরণ:

  • একটি সন্নিবেশ আদেশের অধীনে সমস্ত লাইন আইটেম: insertionOrderId="1234"
  • একটি বিজ্ঞাপনদাতার অধীনে সমস্ত ENTITY_STATUS_ACTIVE বা ENTITY_STATUS_PAUSED এবং LINE_ITEM_TYPE_DISPLAY_DEFAULT লাইন আইটেমগুলি: (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • 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 প্রতিনিধিত্ব
{
  "lineItems": [
    {
      object (LineItem)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
lineItems[]

object ( LineItem )

লাইন আইটেম তালিকা.

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

nextPageToken

string

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

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

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

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

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