Method: targetingTypes.targetingOptions.search

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

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

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
targetingType

enum (TargetingType)

ज़रूरी है. फिर से हासिल किए जाने वाले टारगेटिंग विकल्पों का टाइप.

स्वीकार की गई वैल्यू ये हैं:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "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 के लिए जवाब मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

string

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

BusinessChainSearchTerms

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

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

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

string

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

string

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

GeoRegionSearchTerms

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

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

string

आपकी पसंद के भौगोलिक इलाके के लिए खोज क्वेरी. क्वेरी कोई प्रीफ़िक्स हो सकती है, जैसे "New Yor", "Seattle", "USA" वगैरह.