Method: targetingTypes.targetingOptions.search

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

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

POST https://displayvideo.googleapis.com/v4/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

नतीजों के उस पेज की पहचान करने वाला टोकन जिसे सर्वर को दिखाना चाहिए. आम तौर पर, यह targetingOptions.search वाले तरीके के पिछले कॉल से मिली nextPageToken की वैल्यू होती है. अगर कोई नंबर नहीं दिया जाता है, तो नतीजों का पहला पेज दिखेगा.
यूनियन फ़ील्ड 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

खोज के लिए इस्तेमाल की गई क्वेरी, जिसमें पीओआई का नाम, सड़क का पता या कोऑर्डिनेट शामिल हो. क्वेरी, प्रीफ़िक्स हो सकती है. जैसे, "Times squar", "40.7505045,-73.99562", "315 W 44th St" वगैरह.

BusinessChainSearchTerms

कारोबार की चेन को टारगेट करने के विकल्पों के लिए खोज के लिए इस्तेमाल हुए शब्द.

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

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

string

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

string

अपनी पसंद के भौगोलिक इलाके के लिए खोज क्वेरी, जैसे कि "सिऐटल", "अमेरिका".

GeoRegionSearchTerms

जगह के हिसाब से टारगेटिंग के विकल्पों के लिए खोज के लिए इस्तेमाल हुए शब्द.

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

string

अपनी पसंद के भौगोलिक इलाके के लिए खोज क्वेरी. क्वेरी, प्रीफ़िक्स हो सकती है. जैसे, "न्यूयॉर्क", "सिएटल", "अमेरिका" वगैरह.