Method: advertisers.lineItems.bulkUpdate

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

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

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

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

POST https://displayvideo.googleapis.com/v4/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 देखें.