Method: targetingTypes.targetingOptions.search

यह फ़ंक्शन, दिए गए खोज शब्दों के आधार पर, किसी दिए गए टाइप के टारगेटिंग विकल्पों को खोजता है.

एचटीटीपी अनुरोध

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

यह यूआरएल, 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)

पीओआई टारगेटिंग के विकल्पों के लिए खोजे गए शब्द. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब 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 Overview देखें.

PoiSearchTerms

पीओआई टारगेटिंग के विकल्पों के लिए खोजे गए शब्द.

JSON के काेड में दिखाना 
{
  "poiQuery": string
}
फ़ील्ड
poiQuery

string

यह खोज क्वेरी, किसी पसंदीदा जगह के नाम, सड़क के पते या उसके कोऑर्डिनेट के लिए होती है. क्वेरी, प्रीफ़िक्स हो सकती है. उदाहरण के लिए, "टाइम्स स्क्वेयर", "40.7505045,-73.99562", "315 वेस्ट 44वीं स्ट्रीट" वगैरह.

BusinessChainSearchTerms

कारोबार की चेन को टारगेट करने के विकल्पों के लिए खोज के शब्द.

कम से कम एक फ़ील्ड में जानकारी भरी जानी चाहिए.

JSON के काेड में दिखाना 
{
  "businessChainQuery": string,
  "regionQuery": string
}
फ़ील्ड
businessChainQuery

string

कारोबार की उस चेन के लिए खोज क्वेरी जिसके बारे में आपको जानकारी चाहिए. क्वेरी में कारोबार का पूरा नाम होना चाहिए. जैसे, "KFC", "mercedes-benz".
regionQuery

string

चुने गए भौगोलिक क्षेत्र के लिए खोज क्वेरी, जैसे कि "सिएटल", "अमेरिका".

GeoRegionSearchTerms

जगह के हिसाब से टारगेट करने के विकल्पों के लिए खोज क्वेरी.

JSON के काेड में दिखाना 
{
  "geoRegionQuery": string
}
फ़ील्ड
geoRegionQuery

string

चुने गए भौगोलिक क्षेत्र के लिए खोज क्वेरी. क्वेरी कोई प्रीफ़िक्स हो सकती है. जैसे, "New Yor", "Seattle", "USA" वगैरह.