REST Resource: exchanges.orders.products

संसाधन: प्रॉडक्ट

प्रॉडक्ट

JSON के काेड में दिखाना
{
  "name": string,
  "displayName": string,
  "externalDealId": string,
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "updateTime": string,
  "startTime": string,
  "endTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "creativeConfig": [
    {
      object (CreativeConfig)
    }
  ],
  "makegood": boolean,
  "makegoodDetails": {
    object (MakegoodDetails)
  },
  "creativeSource": enum (CreativeSource),
  "mediumType": enum (MediumType),
  "audienceTargetingConfig": {
    object (AudienceTargetingConfig)
  },
  "targetingCriteria": {
    object (TargetingCriteria)
  },
  "forecastResult": {
    object (ForecastResult)
  },
  "errorDetails": {
    object (ErrorDetails)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "program": string,
  "buyerCustomParameters": {
    string: string,
    ...
  },
  "etag": string
}
फ़ील्ड
name

string

प्रॉडक्ट के लिए रिलेटिव रिसॉर्स नेम. सर्वर से जनरेट किया गया. उदाहरण: "exchanges/1234/orders/5678/products/abc". सिर्फ़ आउटपुट के लिए.

displayName

string

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

यह UTF-8 कोड में होना चाहिए और इसका साइज़ ज़्यादा से ज़्यादा 240 बाइट होना चाहिए. ज़रूरी है.

externalDealId

string

बाहरी आईडी. यह एक्सचेंज सिस्टम पर मौजूद डील आईडी है. ज़्यादा से ज़्यादा 100 वर्ण. अक्षर, अंक, अंडरस्कोर, डैश, और बिंदु का इस्तेमाल किया जा सकता है. यह सभी प्रॉडक्ट के लिए यूनीक होना चाहिए. ज़रूरी है.

transactionType

enum (TransactionType)

प्रॉडक्ट के लेन-देन का टाइप. ज़रूरी है.

pricingType

enum (PricingType)

प्रॉडक्ट के लिए कीमत का टाइप. ज़रूरी है.

updateTime
(deprecated)

string (Timestamp format)

प्रॉडक्ट को आखिरी बार अपडेट किए जाने का टाइमस्टैंप.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

startTime

string (Timestamp format)

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

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

वह समय जब यह प्रॉडक्ट इनऐक्टिव हो जाता है. साल 2036 के बाद की नहीं होनी चाहिए. ज़रूरी है.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

rateDetails

object (RateDetails)

किराये की जानकारी. ज़रूरी है.

creativeConfig[]

object (CreativeConfig)

किसी प्रॉडक्ट के लिए क्रिएटिव से जुड़ी ज़रूरी शर्तें. लेन-देन के टाइप के लिए रिज़र्व किए गए प्रॉडक्ट के लिए ज़रूरी है.

makegood
(deprecated)

boolean

इससे पता चलता है कि कोई प्रॉडक्ट, मेकगुड प्रॉडक्ट है या नहीं.

makegoodDetails
(deprecated)

object (MakegoodDetails)

किसी प्रॉडक्ट के लिए, मेकगुड की जानकारी. यह एट्रिब्यूट तब ज़रूरी होता है, जब प्रॉडक्ट विज्ञापन की गड़बड़ी ठीक करना हो.

creativeSource

enum (CreativeSource)

किसी प्रॉडक्ट के लिए क्रिएटिव सोर्स. यह ज़रूरी नहीं है. डिफ़ॉल्ट रूप से, CREATIVE_SOURCE_ADVERTISER पर सेट होता है. प्रॉडक्ट बनाने के बाद, इसे बदला नहीं जा सकता.

mediumType

enum (MediumType)

किसी प्रॉडक्ट के लिए मीडियम टाइप. अगर पुराने सिस्टम के साथ काम करने की सुविधा के लिए कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू DIGITAL होती है. प्रॉडक्ट बनाने के बाद, इसे बदला नहीं जा सकता.

audienceTargetingConfig

object (AudienceTargetingConfig)

ज़रूरी नहीं. एक्सचेंज पर डील लेवल पर लागू की गई ऑडियंस टारगेटिंग कॉन्फ़िगरेशन.

targetingCriteria

object (TargetingCriteria)

सिर्फ़ आउटपुट के लिए. प्रॉडक्ट टारगेटिंग की शर्तों के रेफ़रंस. यह सिर्फ़ इंस्टैंट डील के मामलों पर लागू होता है.

forecastResult

object (ForecastResult)

प्रॉडक्ट के अनुमान के नतीजे. यह तब ज़रूरी है, जब टारगेटिंग की शर्तें खाली न हों और पूर्वानुमान न दिया गया हो. यह सिर्फ़ इंस्टैंट डील के मामलों पर लागू होता है.

errorDetails

object (ErrorDetails)

जब प्रॉडक्ट के कुछ फ़ील्ड अपडेट नहीं किए जा सकते, तो गड़बड़ी की जानकारी देना ज़रूरी है. यह तब ज़रूरी होता है, जब टारगेटिंग की शर्त की वजह से अनुमान का नतीजा नहीं दिया जा सकता या प्रॉडक्ट को अपडेट नहीं किया जा सकता. यह सिर्फ़ इंस्टैंट डील के मामलों पर लागू होता है.

frequencyCap

object (FrequencyCap)

सिर्फ़ आउटपुट के लिए. खरीदार ने फ़्रीक्वेंसी कैप चुना है. यह सिर्फ़ इंस्टैंट डील के मामलों पर लागू होता है.

program

string

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

buyerCustomParameters

map (key: string, value: string)

सिर्फ़ आउटपुट के लिए. खरीदार ने इंस्टैंट डील के अनुरोध पर, कस्टम की/वैल्यू पैरामीटर सेट किए हैं. यह सिर्फ़ इंस्टैंट डील के मामलों पर लागू होता है.

एक ऑब्जेक्ट, जिसमें "key": value जोड़ों की सूची शामिल हो. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

etag

string

एक etag, जिसे किसी प्रॉडक्ट को अपडेट करते समय बताना ज़रूरी है. अगर etag फ़ील्ड खाली नहीं है, तो इसे सिर्फ़ अपडेट के लिए तय करना ज़रूरी है. यह सिर्फ़ इंस्टैंट डील के मामलों पर लागू होता है.

CreativeConfig

किसी प्रॉडक्ट के लिए क्रिएटिव की ज़रूरी शर्तों का कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "creativeType": enum (CreativeType),
  "dimensionCreativeConfig": {
    object (DimensionCreativeConfig)
  },
  "durationCreativeConfig": {
    object (DurationCreativeConfig)
  }
}
फ़ील्ड
creativeType

enum (CreativeType)

क्रिएटिव टाइप. ज़रूरी है.

dimensionCreativeConfig

object (DimensionCreativeConfig)

डिसप्ले क्रिएटिव के लिए कॉन्फ़िगरेशन. नेटिव क्रिएटिव (CREATIVE_TYPE_NATIVE) के लिए, इस फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

durationCreativeConfig

object (DurationCreativeConfig)

वीडियो क्रिएटिव के लिए कॉन्फ़िगरेशन.

CreativeType

संभावित क्रिएटिव टाइप.

Enums
CREATIVE_TYPE_UNSPECIFIED क्रिएटिव टाइप की जानकारी नहीं दी गई है. इनपुट वैल्यू मान्य नहीं है.
CREATIVE_TYPE_DISPLAY डिसप्ले का क्रिएटिव टाइप.
CREATIVE_TYPE_VIDEO वीडियो का क्रिएटिव टाइप.
CREATIVE_TYPE_AUDIO ऑडियो का क्रिएटिव टाइप.
CREATIVE_TYPE_NATIVE नेटिव विज्ञापन का क्रिएटिव टाइप. RESERVED लेन-देन टाइप वाले प्रॉडक्ट के लिए, यह सुविधा काम नहीं करती.

DimensionCreativeConfig

पिक्सल में क्रिएटिव का डाइमेंशन दिखाएं.

JSON के काेड में दिखाना
{
  "width": integer,
  "height": integer
}
फ़ील्ड
width

integer

डिसप्ले क्रिएटिव की चौड़ाई. ज़रूरी है.

height

integer

डिसप्ले क्रिएटिव की ऊंचाई. ज़रूरी है.

DurationCreativeConfig

क्रिएटिव की अवधि के लिए कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "duration": string,
  "durationMatchType": enum (DurationMatchType),
  "skippableMatchType": enum (SkippableMatchType)
}
फ़ील्ड
duration

string (Duration format)

वीडियो क्रिएटिव की अवधि (सेकंड में). ज़रूरी है

सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".

durationMatchType

enum (DurationMatchType)

अवधि मैच करने की शर्तें.

skippableMatchType

enum (SkippableMatchType)

वीडियो क्रिएटिव का स्किप किया जा सकने वाला टाइप.

DurationMatchType

वीडियो क्रिएटिव की अवधि के लिए, मैच करने की ज़रूरी शर्तें.

Enums
DURATION_MATCH_TYPE_UNSPECIFIED इस वर्शन में, अवधि मैच करने की शर्त नहीं बताई गई है या इसकी जानकारी नहीं है. इनपुट वैल्यू मान्य नहीं है.
DURATION_MATCH_TYPE_EQUAL_TO क्रिएटिव की अवधि, ज़रूरी अवधि के बराबर होनी चाहिए.
DURATION_MATCH_TYPE_LESS_THAN_OR_EQUAL_TO क्रिएटिव की अवधि, ज़रूरी अवधि के बराबर या उससे कम होनी चाहिए.

SkippableMatchType

वीडियो क्रिएटिव को स्किप किया जा सकता है या नहीं, यह तय करने के लिए मैच करने की शर्तें.

Enums
SKIPPABLE_MATCH_TYPE_UNSPECIFIED इस वर्शन में, स्किप किए जा सकने वाले टाइप की जानकारी नहीं दी गई है या इसके बारे में जानकारी नहीं है. इनपुट वैल्यू मान्य नहीं है.
SKIPPABLE_MATCH_TYPE_SKIPPABLE क्रिएटिव, स्किप किया जा सकने वाला होना चाहिए.
SKIPPABLE_MATCH_TYPE_NOT_SKIPPABLE क्रिएटिव को स्किप नहीं किया जा सकता.
SKIPPABLE_MATCH_TYPE_ANY क्रिएटिव स्किप किया जा सकने वाला या स्किप न किया जा सकने वाला हो सकता है.

MakegoodDetails

विज्ञापन की गड़बड़ी ठीक करने की जानकारी का कॉन्फ़िगरेशन.

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

string

मेकगुड का अनुरोध करने वाली बाहरी डील का मूल आईडी. ज़्यादा से ज़्यादा 100 वर्ण. अक्षर, अंक, अंडरस्कोर, डैश, और बिंदु का इस्तेमाल किया जा सकता है. ज़रूरी है.

reason

string

विक्रेता की ओर से, विज्ञापन की गड़बड़ी ठीक करने की वजह. ज़्यादा से ज़्यादा 250 वर्ण. ज़रूरी है.

CreativeSource

क्रिएटिव सोर्स; जहां से क्रिएटिव दिखाए जाएंगे.

Enums
CREATIVE_SOURCE_UNSPECIFIED इस वर्शन में, क्रिएटिव का सोर्स नहीं बताया गया है या वह अज्ञात है. इनपुट वैल्यू मान्य नहीं है.
CREATIVE_SOURCE_ADVERTISER क्रिएटिव, DV3 से दिखाए जाएंगे.
CREATIVE_SOURCE_PUBLISHER क्रिएटिव, पब्लिशर दिखाएगा. फ़िलहाल, पब्लिशर के होस्ट किए गए क्रिएटिव इस्तेमाल नहीं किए जा सकते. क्रिएटिव सोर्स को CREATIVE_SOURCE_PUBLISHER पर सेट करने का कोई भी अनुरोध पूरा नहीं होगा.

AudienceTargetingConfig

ऑडियंस टारगेटिंग के लिए कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "audienceType": enum (AudienceType)
}
फ़ील्ड
audienceType

enum (AudienceType)

ऑडियंस टाइप. ज़रूरी है.

AudienceType

ऑडियंस टाइप.

Enums
AUDIENCE_TYPE_UNSPECIFIED ऑडियंस टाइप की जानकारी नहीं है. इनपुट के लिए मान्य नहीं है.
AUDIENCE_TYPE_COMMERCE कॉमर्स ऑडियंस का टाइप.

TargetingCriteria

टारगेटिंग की ज़रूरी शर्तें तय की गई हैं.

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

object (SelectedTargetingOption)

चुने गए विकल्प.

SelectedTargetingOption

टारगेटिंग के किसी एक टाइप के लिए, टारगेटिंग के चुने गए विकल्प.

JSON के काेड में दिखाना
{
  "type": enum (TargetingType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "audienceSelection": {
    object (AudienceSelection)
  },
  "targetingSelection": {
    object (TargetingSelection)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
type

enum (TargetingType)

चुने गए विकल्पों से जुड़ा टारगेटिंग टाइप.

सिर्फ़ एक तरह का डेटा शामिल किया जा सकता है. चुना गया विकल्प, type फ़ील्ड के लिए चुने गए TargetingType से मेल खाना चाहिए. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
audienceSelection

object (AudienceSelection)

चुनी गई ऑडियंस.

targetingSelection

object (TargetingSelection)

चुने गए विकल्प के आईडी का सामान्य सेट.

एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

TargetingType

टारगेटिंग के टाइप.

Enums
TARGETING_TYPE_UNSPECIFIED टारगेटिंग का टाइप नहीं बताया गया है. यह इनपुट के लिए मान्य नहीं है.
TARGETING_TYPE_AUDIENCE टारगेटिंग के टाइप ऑडियंस.
TARGETING_TYPE_COUNTRY टारगेटिंग टाइप के तौर पर देश को चुना गया है.
TARGETING_TYPE_DMA टारगेटिंग का टाइप डीएमए.
TARGETING_TYPE_PROGRAMMER टारगेटिंग के टाइप प्रोग्रामर.
TARGETING_TYPE_BRAND टारगेटिंग के टाइप ब्रैंड.
TARGETING_TYPE_CONTENT_GENRE टारगेटिंग के टाइप के तौर पर कॉन्टेंट की शैली.
TARGETING_TYPE_DEVICE टारगेटिंग टाइप डिवाइस.
TARGETING_TYPE_OPERATING_SYSTEM टारगेटिंग के टाइप ऑपरेटिंग सिस्टम.
TARGETING_TYPE_RATING टारगेटिंग के टाइप की रेटिंग.
TARGETING_TYPE_ENVIRONMENT टारगेटिंग टाइप एनवायरमेंट.
TARGETING_TYPE_LANGUAGE टारगेटिंग के टाइप के तौर पर भाषा.
TARGETING_TYPE_GEO इलाके के हिसाब से टारगेटिंग का टाइप.
TARGETING_TYPE_AGE उम्र के हिसाब से टारगेटिंग.
TARGETING_TYPE_GENDER लिंग के हिसाब से टारगेटिंग.
TARGETING_TYPE_CONTEXTUAL_SEGMENT टारगेटिंग के टाइप के तौर पर कॉन्टेक्स्ट के हिसाब से सेगमेंट.
TARGETING_TYPE_REQUEST_FORMAT टारगेटिंग के टाइप के अनुरोध का फ़ॉर्मैट.
TARGETING_TYPE_PUBLISHER टारगेटिंग के टाइप के हिसाब से पब्लिशर.
TARGETING_TYPE_INVENTORY_SIZE टारगेटिंग टाइप का साइज़.
TARGETING_TYPE_NETWORK टारगेटिंग के टाइप नेटवर्क.
TARGETING_TYPE_PLATFORM टारगेटिंग के टाइप के तौर पर प्लैटफ़ॉर्म.
TARGETING_TYPE_VIDEO_DELIVERY_TYPE टारगेटिंग के टाइप के तौर पर वीडियो डिलीवरी टाइप.
TARGETING_TYPE_VIDEO_MINIMUM_PLAYER_SIZE टारगेटिंग के टाइप वीडियो के लिए, प्लेयर का कम से कम साइज़.
TARGETING_TYPE_VIDEO_COMPLETION टारगेटिंग के टाइप वीडियो प्लेसमेंट.
TARGETING_TYPE_VIEWABILITY टारगेटिंग के टाइप के हिसाब से विज्ञापन दिखने की दर.
TARGETING_TYPE_REWARDED टारगेटिंग के टाइप के लिए इनाम दिया गया.
TARGETING_TYPE_VIDEO_AD_DURATION_THRESHOLD_SEC टारगेटिंग टाइप के हिसाब से, वीडियो विज्ञापन की अवधि की थ्रेशोल्ड सेकंड में.
TARGETING_TYPE_VIDEO_PLACEMENT टारगेटिंग के टाइप वीडियो प्लेसमेंट.
TARGETING_TYPE_VIDEO_PLAYBACK_METHOD टारगेटिंग के टाइप के तौर पर वीडियो चलाने का तरीका.
TARGETING_TYPE_APP_ID टारगेटिंग टाइप ऐप्लिकेशन आईडी.
TARGETING_TYPE_DOMAIN_URL टारगेटिंग के टाइप के लिए डोमेन यूआरएल.
TARGETING_TYPE_CTR टारगेटिंग के टाइप के हिसाब से क्लिक मिलने की दर (सीटीआर).
TARGETING_TYPE_DEMOGRAPHICS टारगेटिंग के टाइप के तौर पर डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) को चुना गया हो.
TARGETING_TYPE_RESTRICTED_CATEGORY टारगेटिंग के टाइप के लिए पाबंदी वाली कैटगरी.
TARGETING_TYPE_AD_POSITION टारगेटिंग टाइप के हिसाब से विज्ञापन का क्रम.
TARGETING_TYPE_DAY_AND_TIME टारगेटिंग के टाइप के तौर पर दिन और समय.
TARGETING_TYPE_RETAIL_MEDIA_AUDIENCE रीटेल मीडिया ऑडियंस को टारगेट करने का टाइप.

AudienceSelection

ऑडियंस टारगेटिंग के चुने गए विकल्प.

JSON के काेड में दिखाना
{
  "includedOrGroups": [
    {
      object (OrGroup)
    }
  ],
  "excludedOptionIds": [
    string
  ]
}
फ़ील्ड
includedOrGroups[]

object (OrGroup)

शामिल किए गए विकल्पों को AND से जोड़ा जाता है. शामिल किया गया हर विकल्प, एक अलग विकल्प हो सकता है या OR से जुड़े विकल्पों का ग्रुप हो सकता है.

excludedOptionIds[]

string (int64 format)

बाहर रखे गए विकल्पों को OR से जोड़ा जाता है.

OrGroup

चुने गए विकल्पों का एक ग्रुप, जो OR से जुड़ा हो.

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

string (int64 format)

चुने गए विकल्प के आईडी.

TargetingSelection

टारगेटिंग के चुने गए और बाहर रखे गए विकल्प, जो टारगेटिंग के ज़्यादातर टाइप पर लागू होते हैं.

JSON के काेड में दिखाना
{
  "optionIds": [
    string
  ],
  "externalIds": [
    string
  ],
  "excludedOptionIds": [
    string
  ],
  "excludedExternalIds": [
    string
  ]
}
फ़ील्ड
optionIds[]

string (int64 format)

सिर्फ़ आउटपुट के लिए. DV360 के चुने गए टारगेटिंग विकल्प के आईडी, एक्सचेंज के साथ शेयर किए गए. इसे excludedOptionIds के साथ दिखाया जा सकता है. हालांकि, इसके लिए ज़रूरी है कि दोनों सूचियां ओवरलैप न हों.

externalIds[]

string

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

excludedOptionIds[]

string (int64 format)

सिर्फ़ आउटपुट के लिए. टारगेटिंग से बाहर रखे गए DV360 के विकल्प के आईडी, जिन्हें एक्सचेंज के साथ शेयर किया गया है. इसे optionIds के साथ दिखाया जा सकता है. हालांकि, इसके लिए ज़रूरी है कि दोनों सूचियां ओवरलैप न हों.

excludedExternalIds[]

string

सिर्फ़ आउटपुट के लिए. एक्सचेंज से मिले, टारगेटिंग के ऐसे विकल्प के आईडी जिन्हें शामिल नहीं किया गया है. इसे externalIds के साथ दिखाया जा सकता है. हालांकि, इसके लिए ज़रूरी है कि दोनों सूचियां ओवरलैप न हों.

ForecastResult

अनुमान का नतीजा बताया गया है.

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

object (Forecast)

पूर्वानुमान. forecastCategory की वैल्यू, बताए गए हर एलिमेंट के लिए यूनीक होनी चाहिए.

पूर्वानुमान

तय की गई फ़ोरकास्ट कैटगरी का फ़ोरकास्ट.

JSON के काेड में दिखाना
{
  "forecastCategory": enum (ForecastCategory),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "number": string,
  "percentage": integer,
  "cpmPrice": {
    object (Money)
  },
  "cpmRange": {
    object (CpmRange)
  },
  "forecastBreakdownData": {
    object (ForecastBreakdownData)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
forecastCategory

enum (ForecastCategory)

अनुमान के आंकड़े में बताई गई अनुमान की कैटगरी.

सिर्फ़ एक तरह का आंकड़े वाला डेटा शामिल किया जा सकता है. भरा गया डेटा, forecastCategory फ़ील्ड से मेल खाना चाहिए. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
number

string (int64 format)

संख्या वाला डेटा.

percentage

integer

प्रतिशत डेटा.

cpmPrice

object (Money)

सीपीएम की कीमत का डेटा.

cpmRange

object (CpmRange)

सीपीएम की कीमत सीमा का डेटा.

forecastBreakdownData

object (ForecastBreakdownData)

पूर्वानुमान के ब्रेकडाउन का डेटा.

एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

ForecastCategory

पूर्वानुमान की कैटगरी.

Enums
FORECAST_CATEGORY_UNSPECIFIED कैटगरी नहीं बताई गई है. इनपुट के लिए मान्य नहीं है.
FORECAST_CATEGORY_TOTAL_OPPORTUNITIES कुल अवसर. संख्या वाला डेटा.
FORECAST_CATEGORY_TOTAL_AUDIENCE दर्शकों की कुल संख्या. संख्या वाला डेटा.
FORECAST_CATEGORY_DIGITAL_TRP डिजिटल टारगेट रेटिंग पॉइंट. प्रतिशत डेटा.
FORECAST_CATEGORY_SUGGESTED_CPM सीपीएम के लिए सुझाई गई कीमत. सीपीएम रेंज या सीपीएम कीमत का डेटा.
FORECAST_CATEGORY_UNIQUE_REACH यूनीक रीच का अनुमान लगाना. संख्या वाला डेटा.
FORECAST_CATEGORY_FORECAST_BREAKDOWN पूर्वानुमान का ब्रेकडाउन. पूर्वानुमान के ब्रेकडाउन का डेटा.

CpmRange

सीपीएम रेंज में, सीपीएम की कम से कम और ज़्यादा से ज़्यादा वैल्यू शामिल होती है.

JSON के काेड में दिखाना
{
  "minCpm": {
    object (Money)
  },
  "maxCpm": {
    object (Money)
  }
}
फ़ील्ड
minCpm

object (Money)

सीपीएम रेंज की निचली सीमा.

maxCpm

object (Money)

सीपीएम रेंज की ऊपरी सीमा.

ForecastBreakdownData

पूर्वानुमान के ब्रेकडाउन डेटा में, पूर्वानुमान के ब्रेकडाउन की सूची होती है.

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

object (ForecastBreakdown)

अनुमान के ब्रेकडाउन की सूची.

ForecastBreakdown

चुने गए टारगेटिंग विकल्प के अनुमान का ब्रेकडाउन.

JSON के काेड में दिखाना
{
  "selectedTargetingOption": {
    object (SelectedTargetingOption)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "impressions": string
  // End of mutually exclusive fields.
}
फ़ील्ड
selectedTargetingOption

object (SelectedTargetingOption)

टारगेटिंग के किसी एक टाइप के लिए, टारगेटिंग के चुने गए विकल्प.

सिर्फ़ एक तरह का ब्रेकडाउन डेटा शामिल किया जा सकता है. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
impressions

string (int64 format)

इंप्रेशन का अनुमान.

एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

ErrorDetails

अपडेट में गड़बड़ियां होने पर, गड़बड़ी की जानकारी दी जाती है.

JSON के काेड में दिखाना
{
  "message": string,
  "instantDealErrorStatus": enum (InstantDealErrorStatus)
}
फ़ील्ड
message

string

अपडेट में गड़बड़ियां होने पर, यह मैसेज दिखता है.

instantDealErrorStatus

enum (InstantDealErrorStatus)

इंस्टैंट डील के लिए, अपडेट में गड़बड़ियां होने पर गड़बड़ी की स्थिति बताई जाती है.

InstantDealErrorStatus

इंस्टैंट डील अपडेट में गड़बड़ियां होने पर, गड़बड़ी की स्थिति बताई जाती है.

Enums
INSTANT_DEAL_ERROR_STATUS_UNSPECIFIED अनजान गड़बड़ी की स्थिति.
INSTANT_DEAL_ERROR_STATUS_INVENTORY_UNAVAILABLE गड़बड़ी की स्थिति से पता चलता है कि इन्वेंट्री उपलब्ध नहीं है.
INSTANT_DEAL_ERROR_STATUS_FORECAST_UNAVAILABLE गड़बड़ी की स्थिति से पता चलता है कि पूर्वानुमान उपलब्ध नहीं है.
INSTANT_DEAL_ERROR_STATUS_INVALID_INPUT गड़बड़ी की स्थिति से पता चलता है कि इनपुट फ़ील्ड अमान्य हैं.

FrequencyCap

किसी उपयोगकर्ता को दी गई समयावधि में, एक ही विज्ञापन कितनी बार दिखाया जा सकता है

JSON के काेड में दिखाना
{
  "timeUnit": enum (TimeUnit),
  "maxImpressions": string
}
फ़ील्ड
timeUnit

enum (TimeUnit)

समय की वह इकाई जिसमें फ़्रीक्वेंसी कैप लागू किया जाएगा.

maxImpressions

string (int64 format)

इस अवधि के दौरान, किसी उपयोगकर्ता को एक ही विज्ञापन ज़्यादा से ज़्यादा कितनी बार दिखाया जा सकता है.

TimeUnit

समय की वह इकाई जिसमें फ़्रीक्वेंसी कैप लागू किया जाएगा.

Enums
TIME_UNIT_UNSPECIFIED समय की इकाई नहीं बताई गई है.
TIME_UNIT_LIFETIME फ़्रीक्वेंसी कैप, पूरी लाइफ़ टाइम के लिए लागू होगा.
TIME_UNIT_MONTHS फ़्रीक्वेंसी कैप को कई महीनों के लिए लागू किया जाएगा.
TIME_UNIT_WEEKS फ़्रीक्वेंसी कैप को कुछ हफ़्तों के लिए लागू किया जाएगा.
TIME_UNIT_DAYS फ़्रीक्वेंसी कैप को कुछ दिनों के लिए लागू किया जाएगा.

तरीके

create

प्रॉडक्ट बनाया जाता है.

get

प्रॉडक्ट की जानकारी फ़ेच करता है.

list

प्रॉडक्ट की सूची दिखाता है.

patch

किसी प्रॉडक्ट को अपडेट करता है.