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

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

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

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