Method: exchanges.orders.products.patch

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

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

PATCH https://dv360seller.googleapis.com/v1beta1/{product.name=exchanges/*/orders/*/products/*}

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

पाथ पैरामीटर

पैरामीटर
product.name

string

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

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

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

JSON के काेड में दिखाना 
{
  "product": {
    "name": string,
    "displayName": string,
    "externalDealId": string,
    "transactionType": enum (TransactionType),
    "pricingType": enum (PricingType),
    "updateTime": string,
    "startTime": string,
    "endTime": string,
    "rateDetails": {
      "rateType": enum (RateType),
      "rate": {
        object (Money)
      },
      "unitsPurchasedCount": string
    },
    "creativeConfig": [
      {
        "creativeType": enum (CreativeType),
        "dimensionCreativeConfig": {
          object (DimensionCreativeConfig)
        },
        "durationCreativeConfig": {
          object (DurationCreativeConfig)
        }
      }
    ],
    "makegood": boolean,
    "makegoodDetails": {
      "originalExternalDealId": string,
      "reason": string
    },
    "creativeSource": enum (CreativeSource),
    "mediumType": enum (MediumType),
    "audienceTargetingConfig": {
      "audienceType": enum (AudienceType)
    },
    "targetingCriteria": {
      "selectedTargetingOptions": [
        {
          object (SelectedTargetingOption)
        }
      ]
    },
    "forecastResult": {
      "forecasts": [
        {
          object (Forecast)
        }
      ]
    },
    "errorDetails": {
      "message": string,
      "instantDealErrorStatus": enum (InstantDealErrorStatus)
    },
    "frequencyCap": {
      "timeUnit": enum (TimeUnit),
      "maxImpressions": string
    },
    "program": string,
    "buyerCustomParameters": {
      string: string,
      ...
    },
    "etag": string
  },
  "updateMask": string
}
फ़ील्ड
product.displayName

string

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

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

string

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

enum (TransactionType)

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

enum (PricingType)

प्रॉडक्ट के लिए कीमत का टाइप. ज़रूरी है.
product.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".
product.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".
product.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".
product.rateDetails

object (RateDetails)

किराये की जानकारी. ज़रूरी है.
product.creativeConfig[]

object (CreativeConfig)

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

boolean

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

object (MakegoodDetails)

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

enum (CreativeSource)

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

enum (MediumType)

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

object (AudienceTargetingConfig)

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

object (TargetingCriteria)

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

object (ForecastResult)

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

object (ErrorDetails)

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

object (FrequencyCap)

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

string

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

map (key: string, value: string)

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

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

string

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

string (FieldMask format)

यह मास्क तय करता है कि किन फ़ील्ड को अपडेट करना है. ज़रूरी है.

यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा लगाकर अलग की गई लिस्ट है. उदाहरण: "user.displayName,photo".

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

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

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

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

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