Method: advertisers.lineItems.generateDefault

• एचटीटीपी अनुरोध
• पाथ पैरामीटर
• अनुरोध का मुख्य हिस्सा
  • JSON काेड में दिखाना
• जवाब का मुख्य हिस्सा
• अनुमति पाने के लिंक
• इसे आज़माएं!

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

• इंसर्शन ऑर्डर का insertionOrderType
• इंसर्शन ऑर्डर का automationType
• दी गई lineItemType

एपीआई का इस्तेमाल करके, 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 असाइन किया जाएगा. हालांकि, ऐसा तब होगा, जब कोई दूसरी वैल्यू सेट न की गई हो. इसके बाद, इस फ़ील्ड को यूज़र इंटरफ़ेस (यूआई), एपीआई या स्ट्रक्चर्ड डेटा फ़ाइलों का इस्तेमाल करके अपडेट किया जा सकता है. चेतावनी: 8 सितंबर, 2025 से, इस फ़ील्ड को सेट करना ज़रूरी होगा. अगर ऐसा नहीं है, तो लाइन आइटम को DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING वैल्यू असाइन की जाएगी. ऐसा तब होगा, जब विज्ञापन देने वाले पैरंट व्यक्ति या कंपनी ने यह एलान किया हो कि वह ईयू में राजनैतिक विज्ञापन नहीं दिखाती है. इसके अलावा, अनुरोध पूरा नहीं किया जाएगा.

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

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

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

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

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

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