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 की खास जानकारी देखें.