Method: targetingTypes.targetingOptions.search

প্রদত্ত সার্চ টার্মের উপর ভিত্তি করে একটি প্রদত্ত প্রকারের টার্গেটিং বিকল্পগুলির জন্য অনুসন্ধান করে৷

HTTP অনুরোধ

POST https://displayvideo.googleapis.com/v1/targetingTypes/{targetingType}/targetingOptions:search

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

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

পরামিতি
targetingType

enum ( TargetingType )

প্রয়োজন। পুনরুদ্ধার করার জন্য টার্গেটিং বিকল্পের ধরন।

গৃহীত মান হল:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "advertiserId": string,
  "pageSize": integer,
  "pageToken": string,

  // Union field search_terms can be only one of the following:
  "poiSearchTerms": {
    object (PoiSearchTerms)
  },
  "businessChainSearchTerms": {
    object (BusinessChainSearchTerms)
  },
  "geoRegionSearchTerms": {
    object (GeoRegionSearchTerms)
  }
  // End of list of possible types for union field search_terms.
}
ক্ষেত্র
advertiserId

string ( int64 format)

প্রয়োজন। এর পরিপ্রেক্ষিতে বিজ্ঞাপনদাতার এই অনুরোধ করা হচ্ছে।

pageSize

integer

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

pageToken

string

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

ইউনিয়ন ফিল্ড search_terms । টার্গেটিং বিকল্পগুলির জন্য অনুসন্ধান করার জন্য প্রশ্নগুলি। search_terms এ শুধুমাত্র একটি ক্ষেত্র পূরণ করা যেতে পারে, এবং তা অবশ্যই targeting_type এর সাথে সঙ্গতিপূর্ণ হতে হবে। search_terms নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
poiSearchTerms

object ( PoiSearchTerms )

POI টার্গেটিং বিকল্পের জন্য অনুসন্ধান পদ। targetingType TARGETING_TYPE_POI হলেই ব্যবহার করা যাবে।

businessChainSearchTerms

object ( BusinessChainSearchTerms )

বিজনেস চেইন টার্গেটিং অপশনের জন্য সার্চ টার্ম। targetingType TARGETING_TYPE_BUSINESS_CHAIN ​​হলেই ব্যবহার করা যেতে পারে।

geoRegionSearchTerms

object ( GeoRegionSearchTerms )

জিও রিজিয়ন টার্গেটিং অপশনের জন্য সার্চ টার্ম। শুধুমাত্র targetingType TARGETING_TYPE_GEO_REGION হলেই ব্যবহার করা যাবে।

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

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

targetingOptions.search এর জন্য প্রতিক্রিয়া বার্তা।

JSON প্রতিনিধিত্ব
{
  "targetingOptions": [
    {
      object (TargetingOption)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
targetingOptions[]

object ( TargetingOption )

টার্গেটিং বিকল্পগুলির তালিকা যা অনুসন্ধানের মানদণ্ডের সাথে মেলে।

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

nextPageToken

string

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

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

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

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

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

PoiSearch টার্মস

POI টার্গেটিং বিকল্পের জন্য অনুসন্ধান পদ।

JSON প্রতিনিধিত্ব
{
  "poiQuery": string
}
ক্ষেত্র
poiQuery

string

পছন্দসই POI নাম, রাস্তার ঠিকানা, বা পছন্দসই POI-এর স্থানাঙ্কের জন্য অনুসন্ধান ক্যোয়ারী৷ প্রশ্নটি একটি উপসর্গ হতে পারে, যেমন "Times squar", "40.7505045,-73.99562", "315 W 44th St" ইত্যাদি।

BusinessChainSearch terms

বিজনেস চেইন টার্গেটিং অপশনের জন্য সার্চ টার্ম।

অন্তত একটি ক্ষেত্র জনবহুল হওয়া উচিত।

JSON প্রতিনিধিত্ব
{
  "businessChainQuery": string,
  "regionQuery": string
}
ক্ষেত্র
businessChainQuery

string

পছন্দসই ব্যবসা চেইন জন্য অনুসন্ধান ক্যোয়ারী. প্রশ্নটি অবশ্যই ব্যবসার পুরো নাম হতে হবে, যেমন "KFC", "mercedes-benz"।

regionQuery

string

কাঙ্খিত জিও অঞ্চলের জন্য অনুসন্ধান ক্যোয়ারী, যেমন "সিয়াটেল", "ইউনাইটেড স্টেট"।

GeoRegionSearch terms

জিও রিজিয়ন টার্গেটিং অপশনের জন্য সার্চ টার্ম।

JSON প্রতিনিধিত্ব
{
  "geoRegionQuery": string
}
ক্ষেত্র
geoRegionQuery

string

পছন্দসই জিও অঞ্চলের জন্য অনুসন্ধান ক্যোয়ারী। প্রশ্নটি একটি উপসর্গ হতে পারে, যেমন "New Yor", "Seattle", "USA" ইত্যাদি।