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.BulkUpdateLineItem के लिए रिस्पॉन्स मैसेज.

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

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