Method: targetingTypes.targetingOptions.search

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

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

POST https://displayvideo.googleapis.com/v1/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 की खास जानकारी देखें.

PoiSearchTerms

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

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

string

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

BusinessChainSearchTerms

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

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

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

string

मनचाहे कारोबार की चेन के लिए खोज क्वेरी. क्वेरी में कारोबार का पूरा नाम होना चाहिए, जैसे कि "केएफ़सी", "मर्सिडीज़-बेंज़".
regionQuery

string

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

GeoRegionSearchTerms

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

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

string

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