Method: advertisers.lineItems.list

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

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

HTTP অনুরোধ

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

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

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

পরামিতি
advertiserId

string ( int64 format)

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

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

পরামিতি
pageSize

integer

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

pageToken

string

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

orderBy

string

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

  • displayName (ডিফল্ট)
  • entityStatus
  • flight.dateRange.endDate
  • updateTime

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

filter

string

লাইন আইটেম বৈশিষ্ট্য দ্বারা ফিল্টার করার অনুমতি দেয়.

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

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক সীমাবদ্ধতা নিয়ে গঠিত।
  • সীমাবদ্ধতা AND বা OR যৌক্তিক অপারেটর দ্বারা একত্রিত করা যেতে পারে। বিধিনিষেধের একটি ক্রম অন্তর্নিহিতভাবে AND ব্যবহার করে।
  • একটি সীমাবদ্ধতার ফর্ম আছে {field} {operator} {value} ।
  • flight.dateRange.endDate এ ব্যবহৃত অপারেটর অবশ্যই (<) এর চেয়ে কম হতে হবে।
  • updateTime ব্যবহৃত অপারেটরটি অবশ্যই GREATER THAN OR EQUAL TO (>=) হতে হবে বা LESS THAN OR EQUAL TO (<=) ।
  • warningMessages এ ব্যবহৃত অপারেটর অবশ্যই HAS (:) হতে হবে।
  • অন্য সব ক্ষেত্রে ব্যবহৃত অপারেটর অবশ্যই EQUALS (=) হতে হবে।
  • সমর্থিত বৈশিষ্ট্য:
    • campaignId
    • displayName
    • insertionOrderId
    • entityStatus
    • lineItemId
    • lineItemType
    • flight.dateRange.endDate (ইনপুট YYYY-MM-DD হিসাবে ফর্ম্যাট করা হয়েছে)
    • warningMessages
    • flight.triggerId
    • updateTime (ISO 8601 ফর্ম্যাটে ইনপুট বা YYYY-MM-DDTHH:MM:SSZ)
    • targetedChannelId
    • targetedNegativeKeywordListId

উদাহরণ:

  • একটি সন্নিবেশ আদেশের অধীনে সমস্ত লাইন আইটেম: 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"
  • সমস্ত লাইন আইটেম যার ফ্লাইটের তারিখ 28 মার্চ, 2019 এর আগে শেষ হয়: flight.dateRange.endDate<"2019-03-28"
  • warningMessages NO_VALID_CREATIVE আছে এমন সমস্ত লাইন আইটেম : warningMessages:"NO_VALID_CREATIVE"
  • 2020-11-04T18:54:47Z (format of ISO 8601) এর চেয়ে কম বা সমান আপডেট টাইম সহ সমস্ত লাইন আইটেম : updateTime<="2020-11-04T18:54:47Z"
  • 2020-11-04T18:54:47Z (format of ISO 8601) এর চেয়ে বেশি বা সমান আপডেট সময় সহ সমস্ত লাইন আইটেম : updateTime>="2020-11-04T18:54:47Z"
  • সমস্ত লাইন আইটেম যেগুলি তাদের লক্ষ্যে নির্দিষ্ট চ্যানেল এবং নির্দিষ্ট নেতিবাচক কীওয়ার্ড তালিকা উভয়ই ব্যবহার করছে: targetedNegativeKeywordListId=789 AND targetedChannelId=12345

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

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

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

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

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

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 ওভারভিউ দেখুন।