Method: advertisers.reachForecast.retrievePlannableUserInterests

यह कुकी, अनुमान लगाने के लिए उपलब्ध Google ऑडियंस (उपयोगकर्ता की दिलचस्पी) को वापस लाती है.

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

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableUserInterests

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले व्यक्ति या कंपनी का आईडी, ताकि उसके लिए प्लान की जा सकने वाली उपयोगकर्ता की रुचियां दिखाई जा सकें.

क्वेरी पैरामीटर

पैरामीटर
productCategory

enum (PlannableProductCategory)

ज़रूरी है. वह प्रॉडक्ट कैटगरी जिसके लिए, प्लान की जा सकने वाली उपयोगकर्ता दिलचस्पी की जानकारी वापस लानी है.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

reachForecast.retrievePlannableUserInterests के लिए जवाब.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
फ़ील्ड
plannableUserInterests[]

object (PlannableUserInterest)

उपयोगकर्ता की दिलचस्पी की उन कैटगरी की सूची जिन्हें प्लान किया जा सकता है (Google ऑडियंस).

अनुमति पाने के लिंक

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/display-video

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.

PlannableUserInterest

यह उपयोगकर्ता की ऐसी दिलचस्पी होती है जिसे टारगेट करने के लिए प्लान किया जा सकता है.

JSON के काेड में दिखाना 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
फ़ील्ड
userInterestDisplayName

string

सिर्फ़ आउटपुट के लिए. दिलचस्पी का डिसप्ले नेम. उदाहरण के लिए, "आउटडोर में दिलचस्पी रखने वाले लोग".
userInterestPath

string

सिर्फ़ आउटपुट के लिए. दिलचस्पी की कैटगरी का पाथ.
userInterestType

string

सिर्फ़ आउटपुट के लिए. ऑडियंस का टाइप. उदाहरण के लिए, "AFFINITY", "IN_MARKET".
userInterest

object (UserInterest)

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता की दिलचस्पी के लिए आइडेंटिफ़ायर.

अनुरोध में बताई गई [productCategory][] के हिसाब से, ऑब्जेक्ट में फ़ील्ड की जानकारी अपने-आप भर जाती है.

  • [userInterestCategory][] को "Youtube" के लिए भरा गया है.
  • "ओपन ऑक्शन" के लिए, [userInterestUserList][] भर दिया गया है.

उपयोगकर्ता रुचि

उपयोगकर्ता की दिलचस्पी का आइडेंटिफ़ायर.

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

string

सिर्फ़ आउटपुट के लिए. दिलचस्पी की कैटगरी का संसाधन नाम. productCategory फ़ील्ड की वैल्यू "Youtube" होने पर यह फ़ील्ड भर जाता है. फ़ॉर्मैट: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता सूची के संसाधन का नाम. productCategory "ओपन ऑक्शन" होने पर यह फ़ील्ड अपने-आप भर जाता है. फ़ॉर्मैट: customers/{customerId}/userLists/{user_list_id}