Method: advertisers.lineItems.bulkUpdate

एक से ज़्यादा लाइन आइटम अपडेट करता है.

एक ही लाइन आइटम को अपडेट करने वाले इन अनुरोधों के साथ, इस एंडपॉइंट के लिए अनुरोध नहीं किए जा सकते:

YouTube और पार्टनर के लाइन आइटम, एपीआई का इस्तेमाल करके न तो बनाए जा सकते हैं और न ही अपडेट किए जा सकते हैं.

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

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:bulkUpdate

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

पाथ के पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले उस व्यक्ति का आईडी जिससे यह लाइन आइटम जुड़ा है.

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

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

जेएसओएन के काेड में दिखाना
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
फ़ील्ड
lineItemIds[]

string (int64 format)

ज़रूरी है. अपडेट किए जाने वाले लाइन आइटम का आईडी.

targetLineItem

object (LineItem)

ज़रूरी है. एक लाइन आइटम ऑब्जेक्ट, जिसमें अपडेट किए जाने वाले फ़ील्ड और lineItemIds में दिए गए सभी लाइन आइटम को असाइन की जाने वाली नई वैल्यू हैं."

updateMask

string (FieldMask format)

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

फ़िलहाल, सिर्फ़ नीचे दिए गए फ़ील्ड का इस्तेमाल किया जा सकता है:

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

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

LineItemService.bulkUpdateLineitems के लिए रिस्पॉन्स मैसेज.

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

जेएसओएन के काेड में दिखाना
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
फ़ील्ड
updatedLineItemIds[]

string (int64 format)

सही तरीके से अपडेट किए गए लाइन आइटम के आईडी.

failedLineItemIds[]

string (int64 format)

उन लाइन आइटम के आईडी जो अपडेट नहीं हो सके.

skippedLineItemIds[]

string (int64 format)

अपडेट के लिए स्किप किए गए लाइन आइटम के आईडी. उदाहरण के लिए, लाइन आइटम में कोई भी बदलाव न करने की वजह से, ग़ैर-ज़रूरी बदलावों को छोड़ दिया जाएगा. साथ ही, उनसे जुड़े लाइन आइटम आईडी को यहां ट्रैक किया जा सकता है.

errors[]

object (Status)

अपडेट न होने वाले लाइन आइटम से मिली गड़बड़ियां.

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

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

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

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