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

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

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

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

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

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

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

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

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

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

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

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

हम वर्शन 2 में नुकसान पहुंचाने वाले कई बदलाव पेश करने जा रहे हैं. इनकी समीक्षा करें साथ ही, आपको इसमें ज़रूरी बदलाव करने होंगे, डिसप्ले और Video 360 API.

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

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

  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.

• कॉल मैनेज करने के लिए, 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 फ़ील्ड को हटा दिया गया है. मैनेज करें AssignedTargetingOption संसाधनों का इस्तेमाल करके, इन्वेंट्री सोर्स असाइन करें TARGETING_TYPE_INVENTORY_SOURCE में से.

• नीचे दिए गए 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 ईनम टाइप. वर्शन 2 पर यह सुविधा काम नहीं करती मैन्युअल ट्रिगर के ऐक्टिवेशन के आधार पर खर्च करने के लिए लाइन आइटम सेट कर सकता है.

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 फ़ील्ड का इस्तेमाल किया जा सकता है.
• Google Analytics 4 पर माइग्रेट करने के लिए, advertisers.lineItems.bulkEditAssignedTargetingOptions कई पंक्तियों में एक ही असाइन किए गए लक्ष्यीकरण विकल्प जोड़ने या निकालने के लिए आइटम.
• Google Analytics 4 पर माइग्रेट करने के लिए, advertisers.lineItems.bulkListAssignedTargetingOptions का इस्तेमाल, एक से ज़्यादा लाइन आइटम में असाइन किए गए टारगेटिंग विकल्पों की सूची बनाने के लिए करें.
• डुप्लीकेट बनाने के लिए, advertisers.lineItems.duplicate का इस्तेमाल किया जा सकता है एक ही इंसर्शन ऑर्डर में, मौजूदा लाइन आइटम के सभी हिस्सों को कॉपी करना कॉन्फ़िगरेशन और टारगेटिंग सेटिंग.

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

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

• 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