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

पिछली बार अपडेट करने की तारीख: 06-12-2022

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 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 वाले तरीके का इस्तेमाल किया गया है.

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

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

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

  • 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 एन्सम वैल्यू के लिए, 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

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

customBiddingAlgorithms सेवा पर कॉल को अपडेट करना

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

दूसरे बदलाव

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

शुरुआती लॉन्च के बाद, 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

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

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

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

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

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

• 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