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

पिछली बार अपडेट करने का समय: 31-10-2023

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

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

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

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

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

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

तीसरे वर्शन के लिए, यूआरएल को इस पर अपडेट करें:

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

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

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

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

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

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

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

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

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

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

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

उन सेवाओं और फ़ील्ड के रेफ़रंस हटाए गए जिनका अब इस्तेमाल नहीं किया जा रहा है

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

दूसरे बदलाव

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

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

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

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

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

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

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