पिछला अपडेट: 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