Method: advertisers.lineItems.bulkUpdate

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

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

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

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

POST https://displayvideo.googleapis.com/v3/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.bulkUpdateLineआइटम के लिए रिस्पॉन्स मैसेज.

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

जेएसओएन के काेड में दिखाना
{
  "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 की खास जानकारी देखें.