Display & Video 360 API के वर्शन 4 से वर्शन 5 पर माइग्रेट करना

पिछली बार अपडेट किए जाने की तारीख़: 22-10-2026

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

v4 से v5 पर माइग्रेट करने के लिए, आपको v5 को कॉल करने के लिए अपने एंडपॉइंट यूआरएल अपडेट करने होंगे. साथ ही, नुकसान पहुंचा सकने वाले बदलावों को ध्यान में रखते हुए अपने ऐप्लिकेशन को अपडेट करना होगा. इसके अलावा, आपको उन नई सुविधाओं की समीक्षा करनी होगी जिनसे आपके इंटिग्रेशन को फ़ायदा हो सकता है.

अपने एपीआई कॉल को वर्शन 4 से वर्शन 5 पर अपडेट करना

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

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

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

v5 के लिए, यूआरएल को इस पर अपडेट करें:

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

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

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

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

Display & Video 360 API के v4 और v5 वर्शन के बीच के सभी अंतर जानने के लिए, रिलीज़ नोट देखें.

नए आईडी और टाइप का इस्तेमाल करने के लिए, इन्वेंट्री सोर्स को वापस पाने और टारगेटिंग को अपडेट करना

Display & Video 360 API v5, इन्वेंट्री सोर्स की डील और नीलामी पैकेज को वापस पाने और टारगेट करने के तरीके में बदलाव करता है.

v4 में, inventorySources सेवा का इस्तेमाल करके वापस लाए गए InventorySource संसाधन, इन्वेंट्री सोर्स डील और नीलामी पैकेज, दोनों को दिखाते हैं. TARGETING_TYPE_INVENTORY_SOURCE का इस्तेमाल करके, डील और नीलामी पैकेज, दोनों को टारगेट किया जाता है.

v5 में, इन्वेंट्री सोर्स की डील और नीलामी पैकेज को अलग-अलग मैनेज किया जाता है:

  • इन्वेंट्री सोर्स डील को TARGETING_TYPE_INVENTORY_SOURCE_DEAL का इस्तेमाल करके टारगेट किया जाता है. साथ ही, advertisers.inventorySources और partners.inventorySources सेवाओं का इस्तेमाल करके वापस लाया जाता है. इसके अलावा, inventorySourceDetails के AssignedTargetingOption फ़ील्ड का इस्तेमाल करके टारगेट किया जाता है.
  • नीलामी पैकेज को TARGETING_TYPE_AUCTION_PACKAGE का इस्तेमाल करके टारगेट किया जाता है. साथ ही, targetingTypes.targetingOptions सेवा का इस्तेमाल करके वापस लाया जाता है. इसके अलावा, AssignedTargetingOption फ़ील्ड auctionPackageDetails का इस्तेमाल करके टारगेट किया जाता है.

इस अपडेट से, मौजूदा डील और नीलामी पैकेज के लिए इस्तेमाल किए जाने वाले आईडी बदल जाते हैं. इसलिए, माइग्रेशन के बाद, पहले से कैश मेमोरी में सेव किए गए किसी भी InventorySource रिसॉर्स आईडी का इस्तेमाल नहीं किया जा सकता.

इन बदलावों के अलावा, v5 में इन्वेंट्री सोर्स के ऐक्सेसर बनाने, अपडेट करने, और उनमें बदलाव करने की सुविधा भी हटा दी गई है.

मांग बढ़ाने में मदद करने वाले कैंपेन और YouTube के संसाधनों के लिए, ऑडियंस टारगेटिंग लॉजिक को अपडेट करना

Display & Video 360 API v5, मांग बढ़ाने में मदद करने वाले कैंपेन और YouTube के संसाधनों के लिए, ऑडियंस टारगेटिंग के लॉजिक को अपडेट करता है. इससे, टारगेट की गई हर ऑडियंस सूची के लिए, असाइन किए गए अलग-अलग विकल्पों का इस्तेमाल किया जा सकता है.

v4 में, सभी ऑडियंस टारगेटिंग को TARGETING_TYPE_AUDIENCE_GROUP का इस्तेमाल करके मैनेज किया जाता है.

v5 में, मांग बढ़ाने में मदद करने वाले कैंपेन और YouTube विज्ञापन ग्रुप को असाइन की गई ऑडियंस टारगेटिंग को मैनेज करने के लिए, इनमें से किसी एक टारगेटिंग टाइप और AssignedTargetingOption रिसॉर्स फ़ील्ड का इस्तेमाल किया जाता है. यह ऑडियंस के टाइप पर निर्भर करता है:

लाइन आइटम, सभी तरह की ऑडियंस टारगेटिंग को मैनेज करने के लिए, एक ही TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption का इस्तेमाल करना जारी रखेंगे.

कस्टमर मैच की ऑडियंस को मैनेज करने के लिए, Data Manager API पर अपग्रेड करना

Display & Video 360 API के पांचवें वर्शन में, कस्टमर मैच ऑडियंस बनाने और उनकी सदस्यता मैनेज करने की सुविधा हटा दी गई है. इसके लिए, ये तरीके हटाए गए हैं:

  • firstPartyAndPartnerAudiences.create
  • firstPartyAndPartnerAudiences.editCustomerMatchMembers
  • firstPartyAndPartnerAudiences.patch

कस्टमर मैच ऑडियंस को मैनेज करना जारी रखने के लिए, अपने वर्कफ़्लो को अपग्रेड करें, ताकि Data Manager API का इस्तेमाल किया जा सके.

डिजिटल आउट ऑफ़ होम इंसर्शन ऑर्डर वापस पाने की सुविधा जोड़ना

Display & Video 360 API के पांचवें वर्शन में, डिजिटल आउट ऑफ़ होम इंसर्शन ऑर्डर को वापस पाने की सुविधा जोड़ी गई है.

अगर विज्ञापन देने वाले लोग या कंपनियां, डिजिटल आउट ऑफ़ होम विज्ञापन का इस्तेमाल करती हैं, तो advertisers.insertionOrders.list को कॉल करने वाले किसी भी इंटिग्रेशन को अपग्रेड करें. ऐसा इसलिए, ताकि InsertionOrder रिसॉर्स को शामिल किया जा सके. साथ ही, insertionOrderType फ़ील्ड की वैल्यू OUT_OF_HOME हो.

v5 में, डिजिटल आउट ऑफ़ होम इंसर्शन ऑर्डर के तहत लाइन आइटम को वापस पाया जा सकेगा, जैसा कि v4 में किया जा सकता था.

Adloox के रेफ़रंस को Peer39 में अपडेट करना

v5 में, Adloox (इसे Scope3 भी कहा जाता है) के साथ Display & Video 360 के तीसरे पक्ष के ब्रैंड के लिहाज़ से सही होने के इंटिग्रेशन का रेफ़रंस देने वाले फ़ील्ड और enum वैल्यू को Peer39 में अपडेट कर दिया गया है:

  • ThirdPartyVerifierAssignedTargetingOptionDetails फ़ील्ड adloox को peer39 से बदल दिया गया है.
  • PartnerCostType ईनम की वैल्यू PARTNER_COST_TYPE_ADLOOX और PARTNER_COST_TYPE_ADLOOX_PREBID को PARTNER_COST_TYPE_PEER39 और PARTNER_COST_TYPE_PEER39_PREBID से बदल दिया गया है.

YouTube लाइन आइटम, विज्ञापन ग्रुप, और विज्ञापनों के लिए फ़ील्ड अपडेट करना

v5 में, LineItem, AdGroup, और AdGroupAd संसाधनों के कई फ़ील्ड हटा दिए गए हैं या अपडेट कर दिए गए हैं. इन बदलावों को लागू करने के लिए, संसाधन वापस पाने के लॉजिक को अपडेट करें.

LineItem संसाधन में:

LineItem और AdGroup रिसॉर्स में:

  • TargetingExpansionConfig फ़ील्ड audienceExpansionSeedListExcluded और audienceExpansionLevel को हटा दिया गया है.

AdGroupAd संसाधन में:

  • containsSyntheticMedia फ़ील्ड जोड़ा गया है.
  • AudioAd, CommonInStreamAttribute, और VideoPerformanceAd ऑब्जेक्ट में मौजूद trackingUrl फ़ील्ड को दो फ़ील्ड में बांटा गया है: trackingUrl और userSpecifiedTrackingUrl. ऐसा ट्रैकिंग के लिए इस्तेमाल किए गए यूआरएल और उपयोगकर्ता के बताए गए ट्रैकिंग यूआरएल के बीच अंतर करने के लिए किया गया है.

इस्तेमाल से बाहर हो चुकी enum वैल्यू के रेफ़रंस हटाना

v5 में, पहले से बंद की जा चुकी enum वैल्यू को पूरी तरह से हटा दिया गया है. एपीआई को भेजे जाने वाले अनुरोधों में इन वैल्यू का इस्तेमाल करने पर, v4 में गड़बड़ी होगी. हालांकि, इस बदलाव से v5 क्लाइंट लाइब्रेरी से इनका कोई भी रेफ़रंस हट जाएगा. अगर आपके कोड में, अब काम न करने वाली इन वैल्यू का कोई रेफ़रंस मौजूद है, तो v5 पर अपग्रेड करने पर गड़बड़ियां हो सकती हैं.

जिन ईनम टाइप की वैल्यू पर असर पड़ा है उनमें ContentRatingTier, GoogleAudienceType, SdfVersion, और SensitiveCategory शामिल हैं. हटाई गई सभी enum वैल्यू की पूरी सूची के लिए, हमारे रिलीज़ नोट देखें.

नई सुविधाओं की समीक्षा करें

वर्शन 5 में, नुकसान पहुंचा सकने वाले बदलावों के अलावा, ये नई सुविधाएं भी शामिल हैं:

  • विज्ञापन देने वाले व्यक्ति या कंपनी के लेवल पर, YouTube वीडियो और चैनल को टारगेटिंग से बाहर रखने की सुविधा को पूरी तरह से मैनेज किया जा सकता है. इसके लिए, टारगेटिंग के टाइप TARGETING_TYPE_YOUTUBE_VIDEO और TARGETING_TYPE_YOUTUBE_CHANNEL का इस्तेमाल किया जा सकता है. v4 में, इस टारगेटिंग को सिर्फ़ पढ़ा जा सकता था.
  • डिजिटल आउट ऑफ़ होम InsertionOrder रिसॉर्स बनाने की सुविधा.
  • असाइन किए गए क्रिएटिव का इस्तेमाल करने वाले विज्ञापन ग्रुप के लिए सहायता, ताकि AdGroup फ़ील्ड adSource और creativeAssignments और AdGroupAd फ़ील्ड parentCreativeId को जोड़कर विज्ञापन जनरेट किए जा सकें.
  • LookalikeAudience संसाधन बनाने और उन्हें वापस पाने की सुविधा.
  • AdGroupAd रिसॉर्स में एक नया containsSyntheticMedia फ़ील्ड.