Method: advertisers.reachForecast.retrievePlannableProducts

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

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

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

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले व्यक्ति या कंपनी का वह आईडी जिसके लिए प्लान किए जा सकने वाले प्रॉडक्ट की सूची बनानी है.

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

पैरामीटर
plannableLocationId

string

ज़रूरी है. प्लान की जा सकने वाली जगह का आईडी.

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

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

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

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

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

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

object (ProductMetadata)

सिर्फ़ आउटपुट के लिए. प्रॉडक्ट मेटाडेटा की सूची, जिसमें टारगेटिंग के विकल्प दिखाए गए हैं.

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

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

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

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

ProductMetadata

प्लान किए जा सकने वाले प्रॉडक्ट के लिए मेटाडेटा.

JSON के काेड में दिखाना 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
फ़ील्ड
plannableProductDescription

string

सिर्फ़ आउटपुट के लिए. विज्ञापन में दिखाए जाने वाले प्रॉडक्ट की सामान्य टेक्स्ट वाली जानकारी.
plannableProductCode

string

सिर्फ़ आउटपुट के लिए. प्लान किया जा सकने वाला प्रॉडक्ट कोड (जैसे, "YOUTUBE_REACH_MIX").
plannableTargeting

object (PlannableTargeting)

सिर्फ़ आउटपुट के लिए. इस प्रॉडक्ट के लिए उपलब्ध टारगेटिंग की सुविधाएं.
displayName

string

सिर्फ़ आउटपुट के लिए. विज्ञापन प्रॉडक्ट से जुड़ा नाम. उदाहरण के लिए: "वीडियो व्यू कैंपेन".
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

सिर्फ़ आउटपुट के लिए. इस प्रॉडक्ट के लिए मुख्य एट्रिब्यूट.

PlannableTargeting

किसी प्रॉडक्ट के लिए टारगेटिंग की सुविधाएं.

JSON के काेड में दिखाना 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
फ़ील्ड
ageRanges[]

enum (PlannableAgeRange)

सिर्फ़ आउटपुट के लिए. प्रॉडक्ट के लिए, उम्र की उन सीमाओं की अनुमति दी गई है जिनके लिए प्लान किया जा सकता है. असल टारगेटिंग का हिसाब लगाने के लिए, उम्र के इस दायरे को Google की उम्र के हिसाब से की जाने वाली स्टैंडर्ड टारगेटिंग पर मैप किया जाता है.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

सिर्फ़ आउटपुट के लिए. विज्ञापन प्रॉडक्ट के लिए, टारगेट किए जा सकने वाले अलग-अलग प्लैटफ़ॉर्म के कॉम्बिनेशन.
genders[]

enum (Gender)

सिर्फ़ आउटपुट के लिए. विज्ञापन प्रॉडक्ट के लिए, टारगेट किए जा सकने वाले जेंडर.
networks[]

enum (PlannableNetwork)

सिर्फ़ आउटपुट के लिए. विज्ञापन प्रॉडक्ट के लिए टारगेट किए जा सकने वाले नेटवर्क.
devices[]

enum (DeviceType)

सिर्फ़ आउटपुट के लिए. विज्ञापन प्रॉडक्ट के लिए टारगेट किए जा सकने वाले डिवाइस.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

सिर्फ़ आउटपुट के लिए. विज्ञापन प्रॉडक्ट के लिए, टारगेट किए जा सकने वाले YouTube Select लाइनअप.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

सिर्फ़ आउटपुट के लिए. अगर लागू हो, तो इस प्रॉडक्ट के लिए डिफ़ॉल्ट YouTube Select लाइनअप.

SurfaceTargetingCombinations

सरफ़ेस टारगेटिंग के नियम.

JSON के काेड में दिखाना 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
फ़ील्ड
availableSurfaceTypes[]

enum (PlannableSurface)

सिर्फ़ आउटपुट के लिए. उपलब्ध प्लैटफ़ॉर्म टाइप.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

सिर्फ़ आउटपुट के लिए. ऐसे प्लैटफ़ॉर्म के मान्य कॉम्बिनेशन जिन्हें एक साथ चुना जा सकता है.
defaultSurfaceTypes[]

enum (PlannableSurface)

सिर्फ़ आउटपुट के लिए. इस प्रॉडक्ट के लिए डिफ़ॉल्ट तौर पर उपलब्ध प्लैटफ़ॉर्म.

SurfaceTargetingCombination

प्लैटफ़ॉर्म का मान्य कॉम्बिनेशन.

JSON के काेड में दिखाना 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
फ़ील्ड
choices[]

enum (PlannableSurface)

सिर्फ़ आउटपुट के लिए. अलग-अलग प्लैटफ़ॉर्म का कॉम्बिनेशन.

YouTubeSelectLineUp

प्रॉडक्ट टारगेटिंग के लिए, प्लान किया जा सकने वाला YouTube Select लाइनअप.

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

string (int64 format)

सिर्फ़ आउटपुट के लिए. YouTube Select लाइनअप का आईडी.
displayName

string

सिर्फ़ आउटपुट के लिए. YouTube Select लाइनअप का डिसप्ले नेम.

PlannableProductCoreAttributes

प्लान किए जा सकने वाले प्रॉडक्ट के लिए मुख्य एट्रिब्यूट.

JSON के काेड में दिखाना 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
फ़ील्ड
productCategory

enum (PlannableProductCategory)

सिर्फ़ आउटपुट के लिए. प्रॉडक्ट कैटगरी.
buyingMethod

enum (PlannableBuyingMethod)

सिर्फ़ आउटपुट के लिए. खरीदारी का तरीका.
costModel

enum (PlannableCostModel)

सिर्फ़ आउटपुट के लिए. लागत का मॉडल.

PlannableBuyingMethod

प्लान किए जा सकने वाले प्रॉडक्ट को खरीदने का तरीका.

Enums
PLANNABLE_BUYING_METHOD_UNSPECIFIED जानकारी नहीं दी गई है.
PLANNABLE_BUYING_METHOD_AUCTION नीलामी.
PLANNABLE_BUYING_METHOD_RESERVATION बुकिंग पर टैप करें.

PlannableCostModel

प्लान किए जा सकने वाले प्रॉडक्ट का लागत मॉडल.

Enums
PLANNABLE_COST_MODEL_UNSPECIFIED जानकारी नहीं दी गई है.
PLANNABLE_COST_MODEL_CPM सीपीएम का इस्तेमाल करते रहेंगे.
PLANNABLE_COST_MODEL_CPV सीपीवी.
PLANNABLE_COST_MODEL_CPC सीपीसी.
PLANNABLE_COST_MODEL_CPA सीपीए.