v3 से v4 पर माइग्रेट करना

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

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

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

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

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

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

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

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

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

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

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

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

पहले और तीसरे पक्ष की ऑडियंस के संसाधनों और उनसे जुड़ी टारगेटिंग के बारे में अपडेट

FirstAndThirdPartyAudience संसाधनों को FirstPartyAndPartnerAudience संसाधनों से बदल दिया गया है.

इस बदलाव के लिए, आपको यह जानकारी अपडेट करनी होगी:

• FirstAndThirdPartyAudience संसाधनों के रेफ़रंस, ताकि नए FirstPartyAndPartnerAudience संसाधन का इस्तेमाल किया जा सके.
• v3 सेवा में मौजूद तरीकों के लिए किए गए मौजूदा अनुरोधों को नई v4 सेवा firstPartyAndPartnerAudiences पर रीडायरेक्ट किया जाएगा.firstAndThirdPartyAudiences
• 100 से 5,000 आइटम के लिए, firstPartyAndPartnerAudiences.list अनुरोधों के लिए पेज के डिफ़ॉल्ट साइज़ की उम्मीदें.
• v3 firstAndThirdPartyAudienceType फ़ील्ड के रेफ़रंस को नए v4 firstPartyAndPartnerAudienceType फ़ील्ड में बदल दिया गया है. इसके लिए, नए FirstPartyAndPartnerAudienceType enum टाइप का इस्तेमाल किया गया है. साथ ही, पुरानी वैल्यू को इन नई वैल्यू से मैप किया गया है:
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY से TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY से TYPE_PARTNER

• AudienceType एनम वैल्यू LICENSED के रेफ़रंस. इसके बजाय, इनमें से किसी नई और ज़्यादा सटीक वैल्यू का इस्तेमाल करें:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• AssignedTargetingOption संसाधनों के रेफ़रंस, TargetingType TARGETING_TYPE_AUDIENCE_GROUP को AudienceGroupAssignedTargetingOptionDetails में मौजूद v3 फ़ील्ड की जगह इस्तेमाल करने के लिए. इसके लिए, v4 के इन नए फ़ील्ड का इस्तेमाल करें:

  • excludedFirstPartyAndPartnerAudienceGroup की मदद से बनाया गया excludedFirstAndThirdPartyAudienceGroup
  • includedFirstPartyAndPartnerAudienceGroups की मदद से बनाया गया includedFirstAndThirdPartyAudienceGroups

विज्ञापन ग्रुप की टारगेटिंग के लिए, बड़ी संख्या में अनुरोधों वाली मौजूदा सूची को अपडेट करना

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions का नाम बदलकर advertisers.adGroups.bulkListAssignedTargetingOptions कर दिया गया है. नए तरीके के नाम का इस्तेमाल करने के लिए, मौजूदा अनुरोधों को अपडेट करें.

इंसर्शन ऑर्डर बनाते समय, ऑप्टिमाइज़ेशन का मकसद शामिल करना

optimizationObjective अब InsertionOrder संसाधन में एक ज़रूरी फ़ील्ड है. अपने advertisers.insertionOrders.create अनुरोधों को अपडेट करें, ताकि यह पुष्टि की जा सके कि यह फ़ील्ड सेट है.

क्रिएटिव संसाधन फ़ील्ड publisherReviewStatuses के रेफ़रंस हटा दिए गए हैं

जून 2024 में बंद कर दिए जाने के बाद, publisherReviewStatuses फ़ील्ड को Creative संसाधन के तहत ReviewStatusInfo ऑब्जेक्ट से हटा दिया गया है.