8 सितंबर, 2025 से, हर नए लाइन आइटम को यह बताना होगा कि वह यूरोपियन यूनियन (ईयू) में राजनैतिक विज्ञापन दिखाएगा या नहीं. Display & Video 360 API और एसडीएफ़ अपलोड करने की उन कार्रवाइयों को पूरा नहीं किया जा सकेगा जिनमें एलान नहीं किया गया है. इस बारे में ज़्यादा जानने के लिए कि इंटिग्रेशन को अपडेट करके यह एलान कैसे किया जाए, हमारा हटाए गए टैग और एट्रिब्यूट का पेज देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

वर्शन 2 से वर्शन 3 पर माइग्रेट करें

पिछली बार अपडेट करने की तारीख: 31-10-2023

अपना ऐप्लिकेशन माइग्रेट करना

v2 से v3 पर माइग्रेट करने के लिए, आपको v3 को कॉल करने के लिए अपने एंडपॉइंट यूआरएल अपडेट करने होंगे. साथ ही, अपने ऐप्लिकेशन को अपडेट करना होगा, ताकि वह बदलावों को लागू कर सके.

अपने एपीआई कॉल को v2 से v3 पर अपडेट करना

v2 के बजाय v3 का इस्तेमाल करने के लिए, आपको अपने अनुरोधों को नए v3 एंडपॉइंट का इस्तेमाल करने के लिए अपडेट करना होगा.

उदाहरण के लिए, v2 के साथ advertisers.get तरीके को कॉल करने के लिए, आपको इस यूआरएल का इस्तेमाल करना होगा:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

v3 के लिए, यूआरएल को यहां दिए गए यूआरएल में अपडेट करें:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

अगर एपीआई से अनुरोध करने के लिए क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो क्लाइंट लाइब्रेरी के सबसे नए वर्शन का इस्तेमाल करें. साथ ही, v3 का इस्तेमाल करने के लिए अपने कॉन्फ़िगरेशन को अपडेट करें.

ज़रूरी बदलाव करना

हम v3 में कई अहम बदलाव कर रहे हैं. नीचे दिए गए निर्देशों को पढ़ें और Display & Video 360 एपीआई के मौजूदा इस्तेमाल के हिसाब से ज़रूरी बदलाव करें.

YouTube के संसाधनों और उनसे जुड़ी टारगेटिंग को वापस लाने वाले कॉल अपडेट करना

YoutubeAdGroup और YoutubeAdGroupAd संसाधनों को AdGroup और AdGroupAd संसाधनों से बदल दिया गया है. ये नए रिसॉर्स, v2 रिसॉर्स की तरह ही जानकारी देते हैं. हालांकि, इनमें अपडेट किए गए फ़ील्ड के नाम या एनम टाइप का इस्तेमाल किया जा सकता है. अपने इंटिग्रेशन में, YoutubeAdGroup या YoutubeAdGroupAd संसाधनों के इस्तेमाल को AdGroup और AdGroupAd संसाधनों से बदलें. साथ ही, यहां दी गई v2 सेवाओं के कॉल को उससे जुड़ी v3 सेवा पर अपडेट करें:
- advertisers.youtubeAdGroupAds से advertisers.adGroupAds
- advertisers.youtubeAdGroups से advertisers.adGroups
- advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions से advertisers.adGroups.targetingTypes.assignedTargetingOptions
YoutubeAndPartnersBiddingStrategy ऑब्जेक्ट के रेफ़रंस, सामान्य BiddingStrategy ऑब्जेक्ट में मौजूद नए youtubeAndPartnersBid फ़ील्ड में ले जाए गए हैं. YoutubeAndPartnersSettingsऑब्जेक्ट से biddingStrategy फ़ील्ड को हटा दिया गया है. LineItem या AdGroup संसाधन में bidStrategy फ़ील्ड में मौजूद BiddingStrategy ऑब्जेक्ट से, YouTube लाइन आइटम या विज्ञापन ग्रुप के लिए बिडिंग की रणनीति पाने के लिए, अपने इंटिग्रेशन को अपडेट करें.
thirdPartyMeasurementSettings फ़ील्ड का नाम बदलकर, YoutubeAndPartnersSettings ऑब्जेक्ट में thirdPartyMeasurementConfigs कर दिया गया है. साथ ही, YoutubeAndPartnersThirdPartyMeasurementSettings ऑब्जेक्ट का नाम बदलकर ThirdPartyMeasurementConfigs कर दिया गया है. नए फ़ील्ड और ऑब्जेक्ट का इस्तेमाल करके, तीसरे पक्ष के मेज़रमेंट कॉन्फ़िगरेशन की जानकारी पाने के लिए, अपने इंटिग्रेशन को अपडेट करें.

विज्ञापन देने वाले खाते बनाते समय, ज़रूरी बिलिंग कॉन्फ़िगरेशन शामिल करना

billingConfig अब Advertiser संसाधन में ज़रूरी फ़ील्ड है. इस फ़ील्ड के सेट होने की पुष्टि करने के लिए, अपने advertisers.create अनुरोध अपडेट करें. पैरंट पार्टनर के लिए, डिफ़ॉल्ट बिलिंग जानकारी को नए Partner संसाधन billingConfig फ़ील्ड से वापस पाया जा सकता है.

ऑप्टिमाइज़ की गई टारगेटिंग को कंट्रोल करने के लिए नए फ़ील्ड का इस्तेमाल करना

TargetingExpansionConfig ऑब्जेक्ट में, targetingExpansionLevel फ़ील्ड की जगह एक नया बूलियन enableOptimizedTargeting फ़ील्ड ले लिया है.

नए केपीआई फ़ील्ड का इस्तेमाल करने के लिए, इंसर्शन ऑर्डर इंटिग्रेशन अपडेट करना

InsertionOrder संसाधन में, performanceGoal फ़ील्ड की जगह एक नया kpi फ़ील्ड ले लिया है. यह नया फ़ील्ड, PerformanceGoal ऑब्जेक्ट की जगह Kpi ऑब्जेक्ट का इस्तेमाल करता है. साथ ही, नए फ़ील्ड और एनम का इस्तेमाल करता है.

अब काम न करने वाली सेवाओं और फ़ील्ड के रेफ़रंस हटाना

पिछली सुविधाओं के बंद होने के हिसाब से, v3 में कई इकाइयों को हटा दिया गया है:

advertisers.manualTriggers सेवा को हटा दिया गया है, क्योंकि मैन्युअल ट्रिगर अब काम नहीं करते.
billableOutcome फ़ील्ड को InsertionOrder संसाधन से हटा दिया गया है, क्योंकि नतीजे के आधार पर खरीदारी की सुविधा बंद कर दी गई है.

दूसरे बदलाव

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

शुरुआती लॉन्च के बाद, v3 में जोड़ी गई सुविधाओं के बारे में रिलीज़ के नोट में बताया गया है.

आस-पास की जगहों की सूची मैनेज करना

v3 में, आस-पास की जगहों की सूचियों को पूरी तरह से मैनेज किया जा सकता है. इससे, TARGETING_LOCATION_TYPE_PROXIMITY LocationList संसाधनों को असाइन की गई जगहों को बनाने और मिटाने के लिए, advertisers.locationLists.assignedLocations सेवा का इस्तेमाल किया जा सकता है. जगहों की पहचान, TARGETING_TYPE_POI TargetingOption संसाधनों के आईडी का इस्तेमाल करके की जाती है. इन्हें targetingTypes.targetingOptions.search का इस्तेमाल करके वापस पाया जा सकता है.

नियमों के आधार पर कस्टम बिडिंग एल्गोरिदम बनाने की सुविधा

v3 में, customBiddingAlgorithms, media, और customBiddingAlgorithms.rules सेवाओं का इस्तेमाल करके, नियम पर आधारित कस्टम बिडिंग एल्गोरिदम बनाए और वापस पाएं.

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