Method: advertisers.lineItems.generateDefault

यह फ़ंक्शन, इंसर्शन ऑर्डर और ENTITY_STATUS_DRAFT entityStatus से इनहेरिट की गई सेटिंग (इसमें टारगेटिंग भी शामिल है) के साथ एक नया लाइन आइटम बनाता है. अगर लाइन आइटम बन जाता है, तो यह फ़ंक्शन नया लाइन आइटम दिखाता है. इन तीन फ़ील्ड के आधार पर डिफ़ॉल्ट वैल्यू तय की जाती हैं:

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

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

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems:generateDefault

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

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

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

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
फ़ील्ड
insertionOrderId

string (int64 format)

ज़रूरी है. उस इंसर्शन ऑर्डर का यूनीक आईडी जिससे लाइन आइटम जुड़ा है.
displayName

string

ज़रूरी है. लाइन आइटम का डिसप्ले नेम.

यह UTF-8 में एन्कोड होना चाहिए और इसका साइज़ ज़्यादा से ज़्यादा 240 बाइट होना चाहिए.
lineItemType

enum (LineItemType)

ज़रूरी है. लाइन आइटम का टाइप.
mobileApp

object (MobileApp)

लाइन आइटम के ज़रिए प्रमोट किया गया मोबाइल ऐप्लिकेशन.

यह सिर्फ़ तब लागू होता है, जब lineItemType की वैल्यू LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL या LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL हो.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

इस लाइन आइटम के ज़रिए, यूरोपियन यूनियन में राजनैतिक विज्ञापन दिखाए जाएंगे या नहीं.

अगर विज्ञापन देने वाले पैरंट व्यक्ति या कंपनी के लिए containsEuPoliticalAds को DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING पर सेट किया गया है, तो इस फ़ील्ड को DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING असाइन किया जाएगा. हालांकि, ऐसा तब होगा, जब कोई दूसरी वैल्यू सेट न की गई हो. इसके बाद, इस फ़ील्ड को यूज़र इंटरफ़ेस (यूआई), एपीआई या स्ट्रक्चर्ड डेटा फ़ाइलों का इस्तेमाल करके अपडेट किया जा सकता है.

नया लाइन आइटम बनाते समय, यह फ़ील्ड असाइन करना ज़रूरी है. ऐसा न करने पर, advertisers.lineItems.create का अनुरोध पूरा नहीं किया जा सकेगा.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में LineItem का एक इंस्टेंस शामिल किया जाता है.

अनुमति के स्कोप

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/display-video

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.