Method: advertisers.locationLists.list

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

HTTP অনুরোধ

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

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

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

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

string (int64 format)

প্রয়োজনীয়। DV360 বিজ্ঞাপনদাতার আইডি যার সাথে ফেচ করা লোকেশন তালিকা সম্পর্কিত।

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

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

integer

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

pageToken

string

সার্ভার যে ফলাফল ফেরত পাঠাবে তার পৃষ্ঠা শনাক্ত করার টোকেন।

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

orderBy

string

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

  • locationListId (ডিফল্ট)
  • displayName

ক্রমানুসারে সাজানোর ডিফল্ট সেটিংস হল ছোট থেকে বড়। কোনও ফিল্ডের জন্য নিম্নক্রম নির্দিষ্ট করতে, ফিল্ডের নামের শেষে "desc" যোগ করতে হবে। উদাহরণ: displayName desc।

filter

string

লোকেশন তালিকার ফিল্ড অনুযায়ী ফিল্টার করার অনুমতি দেয়।

কাজ করে এমন সিনট্যাক্স:

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক বিধিনিষেধ নিয়ে তৈরি হয়।
  • AND বা OR লজিক্যাল অপারেটর ব্যবহার করে বিধিনিষেধ একত্রিত করা যেতে পারে। বিধিনিষেধের একটি ক্রম অন্তর্নিহিতভাবে AND ব্যবহার করে।
  • {field} {operator} {value}-এর ফর্মের উপর বিধিনিষেধ আছে।
  • সব ফিল্ডে অবশ্যই EQUALS (=) অপারেটর ব্যবহার করতে হবে।

যেসব ফিল্ডে কাজ করে:

  • locationType

উদাহরণ:

  • সব আঞ্চলিক লোকেশনের তালিকা: locationType="TARGETING_LOCATION_TYPE_REGIONAL"
  • সব কাছাকাছি লোকেশনের তালিকা: locationType="TARGETING_LOCATION_TYPE_PROXIMITY"

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

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

অনুরোধের বডি

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

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

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

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

object (LocationList)

লোকেশন তালিকার তালিকা।

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

nextPageToken

string

পরবর্তী পৃষ্ঠার ফলাফল পাওয়ার জন্য টোকেন।

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

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

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

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

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