v1 से v2 में माइग्रेट करें

पिछला अपडेट: 06-12-2022

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

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

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

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

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

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

वर्शन 2 के लिए, यूआरएल को यहां अपडेट करें:

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

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

ज़रूरी बदलाव करें

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

कॉल को टारगेट करने के तरीके अपडेट करना

• कुछ टारगेटिंग टाइप को अब टारगेटिंग विकल्प आईडी के बजाय, enum वैल्यू का इस्तेमाल करके असाइन किया जाता है. उदाहरण के लिए, टैबलेट डिवाइसों को अब सीधे तौर पर DEVICE_TYPE_TABLET DeviceType एनम की मदद से टारगेट किया जाता है, न कि targetingTypes.targetingOptions सेवा से मिले टारगेटिंग विकल्प के आईडी की मदद से. इन Enum के स्ट्रिंग वर्शन, इन AssignedTargetingOption संसाधनों के नए assignedTargetingOptionIdAlias फ़ील्ड में दिखाए जाते हैं. इनका इस्तेमाल मौजूदा टारगेटिंग को वापस पाने या मिटाने के लिए किया जा सकता है. इन AssignedTargetingOption संसाधनों की assignedTargetingOptionId वैल्यू में कोई बदलाव नहीं हुआ है.

  Enum वैल्यू का इस्तेमाल करने के लिए, नीचे दिए गए टारगेटिंग टाइप को मैनेज करने वाले कॉल अपडेट करें:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

• advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions तरीके को advertisers.lineItems.bulkEditAssignedTargetingOptions तरीके से बदल दिया गया है.

• advertisers.lineItems.bulkListLineItemAssignedTargetingOptions तरीके को advertisers.lineItems.bulkListAssignedTargetingOptions तरीके से बदल दिया गया है.

• ProximityRadiusRange के एनम की वैल्यू के बजाय, दायरा साइज़ और दूरी की यूनिट को सेट करने के लिए, TARGETING_TYPE_PROXIMITY_LOCATION_LIST को मैनेज करने वाले कॉल अपडेट करें.

• टारगेट करने के उन तरीकों का नाम बदल दिया गया है जो एक ही पैरंट रिसॉर्स के तहत, कई तरह के टारगेटिंग विकल्पों में से, टारगेटिंग के विकल्प फिर से हासिल करते हैं या उनमें बदलाव करते हैं.

  कॉल के नए नाम इस्तेमाल करने के लिए, उन्हें इन तरीकों पर अपडेट करें:

  • advertisers.bulkEditAdvertiserAssignedTargetingOptions से advertisers.editAssignedTargetingOptions
  • advertisers.bulkListAdvertiserAssignedTargetingOptions से advertisers.listAssignedTargetingOptions
  • advertisers.campaigns.bulkListCampaignAssignedTargetingOptions से advertisers.campaigns.listAssignedTargetingOptions
  • advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions से advertisers.insertionOrders.listAssignedTargetingOptions
  • partners.bulkEditPartnerAssignedTargetingOptions से partners.editAssignedTargetingOptions

advertisers.lineItems सेवा के लिए कॉल अपडेट करें

• फ़ील्ड inventorySourceIds को हटा दिया गया है. TARGETING_TYPE_INVENTORY_SOURCE के AssignedTargetingOption संसाधनों का इस्तेमाल करके, इन्वेंट्री के सोर्स का असाइनमेंट मैनेज करें.

• नीचे दी गई LineItemWarningMessage enum वैल्यू, v2 में अब काम नहीं करतीं और अब LineItem.warningMessages में नहीं दिखेंगी:

  • NO_POSITIVE_AUDIENCE_LIST_TARGETED
  • APP_INSTALL_NO_CONVERSION_PIXEL
  • TARGETING_REVOKED_OR_CLOSED_USER_LIST
  • APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
  • CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
  • NO_CREATIVE_FOR_TARGETED_DEALS
  • TARGETING_DEPRECATED_GEO_TARGET

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

customBiddingAlgorithms सेवा के लिए कॉल अपडेट करें

customBiddingAlgorithmState और modelReadiness फ़ील्ड को modelDetails फ़ील्ड से बदल दिया गया है. इससे हर विज्ञापन देने वाले के लिए, CustomBiddingModelDetails ऑब्जेक्ट की सूची के ज़रिए ऐक्सेस करने वाले मौजूदा एल्गोरिदम मॉडल की रेडीनेसऔर निलंबन स्थिति के बारे में पता चलता है.

दूसरे बदलाव

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

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

YouTube लाइन आइटम का रीड ओनली ऐक्सेस

वर्शन 2 में, YouTube लाइन आइटम और उनकी टारगेटिंग सेटिंग को क्रम से advertisers.lineItems और advertisers.lineItems.targetingTypes.assignedTargetingOptions सेवाओं का इस्तेमाल करके फिर से पाया जा सकता है. यह एपीआई रीड-ओनली ऐक्सेस देता है, जिसका मतलब है कि इन लाइन आइटम में लिखने का कोई भी अनुरोध करने पर गड़बड़ी दिखेगी. YouTube लाइन आइटम में इनमें से कोई एक LineItemType वैल्यू होगा:

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

बेहतर परफ़ॉर्मेंस को चालू करने वाले नए तरीके

वर्शन 2 में, advertisers.lineItems सेवा बेहतर परफ़ॉर्मेंस और कोटा के कम इस्तेमाल के लिए, बैच किए गए अनुरोधों के बजाय, इस्तेमाल करने के नए तरीके उपलब्ध कराती है:

• एक से ज़्यादा लाइन आइटम के लिए, एक ही फ़ील्ड वैल्यू सेट करने के लिए advertisers.lineItems.bulkUpdate का इस्तेमाल करें. फ़िलहाल, सिर्फ़ entityStatus फ़ील्ड को अपडेट किया जा सकता है.
• एक से ज़्यादा लाइन आइटम में, असाइन किए गए टारगेटिंग के एक जैसे विकल्पों को जोड़ने या हटाने के लिए, advertisers.lineItems.bulkEditAssignedTargetingOptions का इस्तेमाल किया जा सकता है.
• advertisers.lineItems.bulkListAssignedTargetingOptions का इस्तेमाल करके, एक से ज़्यादा लाइन आइटम में, असाइन किए गए टारगेटिंग विकल्पों की सूची बनाई जा सकती है.
• अपने इंसर्शन ऑर्डर में, किसी मौजूदा लाइन आइटम का डुप्लीकेट बनाने के लिए, advertisers.lineItems.duplicate का इस्तेमाल किया जा सकता है. डुप्लीकेट लाइन आइटम को सभी कॉन्फ़िगरेशन और टारगेटिंग सेटिंग को कॉपी करके कॉपी किया जा सकता है.

इंसर्शन ऑर्डर टारगेटिंग के लिए, लिखने का कुछ ही ऐक्सेस

वर्शन 2 में, InsertionOrder रिसॉर्स के लिए सबसेट टारगेटिंग की सेटिंग में बदलाव किया जा सकता है. ऐसा करने के लिए, advertisers.insertionOrders.targetingTypes.assignedTargetingOptions सेवा में नए create और delete तरीकों का इस्तेमाल किया जा सकता है. नीचे दिए गए टारगेटिंग के टाइप, इंसर्शन ऑर्डर के लेवल पर पूरी तरह से मैनेज किए जा सकते हैं:

• TARGETING_TYPE_AGE_RANGE
• TARGETING_TYPE_BROWSER
• TARGETING_TYPE_CATEGORY
• TARGETING_TYPE_CHANNEL
• TARGETING_TYPE_DEVICE_MAKE_MODEL
• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
• TARGETING_TYPE_ENVIRONMENT
• TARGETING_TYPE_GENDER
• TARGETING_TYPE_KEYWORD
• TARGETING_TYPE_LANGUAGE
• TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
• TARGETING_TYPE_OPERATING_SYSTEM
• TARGETING_TYPE_PARENTAL_STATUS
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
• TARGETING_TYPE_VIEWABILITY