Method: guaranteedOrders.list

নিশ্চিত অর্ডারগুলোর তালিকা দেয় যা বর্তমান ব্যবহারকারীর জন্য অ্যাক্সেসযোগ্য।

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

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v4/guaranteedOrders

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

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

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

integer

অনুরোধকৃত পৃষ্ঠার আকার। অবশ্যই 1 থেকে 200 মধ্যে হতে হবে। নির্দিষ্ট না করা হলে ডিফল্ট হিসেবে 100 ব্যবহৃত হবে।

pageToken

string

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

orderBy

string

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

  • displayName (ডিফল্ট)

ডিফল্ট সর্টিং অর্ডার হলো আরোহী। কোনো ফিল্ডের জন্য অবরোহী ক্রম নির্দিষ্ট করতে হলে, ফিল্ডের নামের শেষে 'desc' সাফিক্সটি যোগ করতে হবে। উদাহরণস্বরূপ, displayName desc ।

filter

string

নিশ্চিত অর্ডার ফিল্ড অনুযায়ী ফিল্টার করার সুবিধা দেয়।

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক সীমাবদ্ধতা দ্বারা গঠিত হয়।
  • AND বা OR লজিক্যাল অপারেটরের মাধ্যমে বিধিনিষেধগুলোকে একত্রিত করা যায়। একাধিক বিধিনিষেধের একটি অনুক্রম পরোক্ষভাবে AND ব্যবহার করে।
  • একটি বিধিনিষেধের গঠন হলো {field} {operator} {value} ।
  • সকল ফিল্ডে অবশ্যই EQUALS (=) অপারেটর ব্যবহার করতে হবে।

সমর্থিত ফিল্ডসমূহ: * guaranteedOrderId * exchange * displayName * status.entityStatus

উদাহরণ:

  • সকল সক্রিয় নিশ্চিত অর্ডার: status.entityStatus="ENTITY_STATUS_ACTIVE"
  • Google Ad Manager বা Rubicon এক্সচেঞ্জের অন্তর্গত নিশ্চিত অর্ডার: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"

এই ফিল্ডটির দৈর্ঘ্য ৫০০ অক্ষরের বেশি হওয়া উচিত নয়।

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

প্রয়োজনীয়।

অনুরোধটি কোন DV360 এনটিটির মধ্যে করা হচ্ছে তা শনাক্ত করে। LIST অনুরোধটি শুধুমাত্র সেইসব গ্যারান্টিযুক্ত অর্ডার এনটিটি ফেরত দেবে যেগুলো accessor মধ্যে শনাক্ত করা DV360 এনটিটির কাছে অ্যাক্সেসযোগ্য। নিম্নলিখিতটি হলো পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডগুলির একটি তালিকা। একটি রেসপন্সে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা থাকবে:

partnerId

string ( int64 format)

সেই অংশীদারের আইডি, যার কাছে নিশ্চিত অর্ডারটির অ্যাক্সেস রয়েছে।

advertiserId

string ( int64 format)

বিজ্ঞাপনদাতার আইডি, যার কাছে নিশ্চিত অর্ডারের অ্যাক্সেস রয়েছে।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

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

JSON উপস্থাপনা 
{
  "guaranteedOrders": [
    {
      object (GuaranteedOrder)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
guaranteedOrders[]

object ( GuaranteedOrder )

নিশ্চিত অর্ডারগুলোর তালিকা।

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

nextPageToken

string

ফলাফলের পরবর্তী পৃষ্ঠা পাওয়ার জন্য একটি টোকেন। ফলাফলের পরবর্তী পৃষ্ঠা পেতে, guaranteedOrders.list মেথডের পরবর্তী কলে pageToken ফিল্ডে এই মানটি পাস করুন।

অনুমোদনের পরিধি

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

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

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