Method: advertisers.lineItems.bulkUpdate

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

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

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

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

string (int64 format)

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

object (LineItem)

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

string (FieldMask format)

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

फ़िलहाल, सिर्फ़ ये फ़ील्ड काम करते हैं:

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

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

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

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

JSON के काेड में दिखाना 
{
  "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 Overview देखें.