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
    },
    "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.etag

string

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

string (FieldMask format)

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

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

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

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

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

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