v1 থেকে v2 তে স্থানান্তর করুন

শেষ আপডেট: 2022-12-06

আপনার আবেদন স্থানান্তর করুন

v1 থেকে v2 তে স্থানান্তরিত করার জন্য v2 কল করার জন্য আপনার এন্ডপয়েন্ট URL গুলি আপডেট করতে হবে এবং পরিবর্তনগুলি ভাঙার জন্য অ্যাকাউন্টে আপনার অ্যাপ্লিকেশন আপডেট করতে হবে৷

v1 থেকে v2 তে আপনার API কলগুলি আপডেট করুন৷

v1 এর পরিবর্তে v2 ব্যবহার করতে, নতুন v2 এন্ডপয়েন্ট ব্যবহার করার জন্য আপনাকে আপনার অনুরোধ আপডেট করতে হবে।

উদাহরণস্বরূপ, v1 দিয়ে advertisers.get পদ্ধতিতে কল করতে, আপনি নিম্নলিখিত URL ব্যবহার করবেন:

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

v2-এর জন্য, নিম্নলিখিতগুলিতে URL আপডেট করুন:

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

আপনি যদি API-তে অনুরোধ করার জন্য একটি ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, ক্লায়েন্ট লাইব্রেরির সবচেয়ে সাম্প্রতিক সংস্করণটি ব্যবহার করুন এবং v2 ব্যবহার করার জন্য আপনার কনফিগারেশন আপডেট করুন।

প্রয়োজনীয় পরিবর্তন করুন

আমরা v2-তে বেশ কয়েকটি ব্রেকিং পরিবর্তন প্রবর্তন করছি। নিম্নলিখিত নির্দেশাবলী পর্যালোচনা করুন এবং Display & Video 360 API-এর আপনার বিদ্যমান ব্যবহারের সাথে প্রাসঙ্গিক প্রয়োজনীয় পরিবর্তনগুলি করুন৷

টার্গেটিং পদ্ধতিতে কল আপডেট করুন

কিছু টার্গেটিং প্রকার এখন টার্গেটিং বিকল্প আইডির পরিবর্তে enum মান ব্যবহার করে বরাদ্দ করা হয়েছে। উদাহরণস্বরূপ, ট্যাবলেট ডিভাইসগুলি এখন targetingTypes.targetingOptions পরিষেবা থেকে টার্গেটিং বিকল্প আইডির পরিবর্তে DEVICE_TYPE_TABLET DeviceType এনাম দিয়ে সরাসরি লক্ষ্যবস্তু করা হয়েছে৷ এই এনামগুলির স্ট্রিং সংস্করণগুলিকে এই AssignedTargetingOption রিসোর্সে নতুন assignedTargetingOptionIdAlias ক্ষেত্রে উপস্থাপন করা হয় এবং বিদ্যমান টার্গেটিং পুনরুদ্ধার বা মুছে ফেলার সময় ব্যবহার করা যেতে পারে। এই AssignedTargetingOption রিসোর্সগুলির assignedTargetingOptionId মান পরিবর্তিত হয়নি।
enum মান ব্যবহার করতে নিম্নলিখিত টার্গেটিং প্রকারগুলি পরিচালনা করে কলগুলি আপডেট করুন:
পদ্ধতি advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions পদ্ধতি advertisers.lineItems.bulkEditAssignedTargetingOptions দ্বারা প্রতিস্থাপিত হয়েছে।
পদ্ধতি advertisers.lineItems.bulkListLineItemAssignedTargetingOptions পদ্ধতি advertisers.lineItems.bulkListAssignedTargetingOptions দ্বারা প্রতিস্থাপিত হয়েছে।
একটি ProximityRadiusRange enum মানের পরিবর্তে একটি সেট ব্যাসার্ধের আকার এবং দূরত্ব ইউনিট ব্যবহার করতে TARGETING_TYPE_PROXIMITY_LOCATION_LIST পরিচালনাকারী কলগুলি আপডেট করুন৷
টার্গেটিং পদ্ধতিগুলি যেগুলি একক অভিভাবক সংস্থানের অধীনে একাধিক টার্গেটিং প্রকার জুড়ে টার্গেটিং বিকল্পগুলি পুনরুদ্ধার বা সম্পাদনা করে তাদের নাম পরিবর্তন করা হয়েছে৷
তাদের নতুন নাম ব্যবহার করতে নিম্নলিখিত পদ্ধতিতে কল আপডেট করুন:

`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 enum প্রকার থেকে সরানো হয়েছে৷ v2 ম্যানুয়াল ট্রিগার সক্রিয়করণের উপর ভিত্তি করে ব্যয় করার জন্য লাইন আইটেম সেট করা সমর্থন করে না।

`customBiddingAlgorithms` পরিষেবাতে কলগুলি আপডেট করুন৷

customBiddingAlgorithmState এবং modelReadiness ক্ষেত্রগুলি modelDetails ফিল্ড দিয়ে প্রতিস্থাপিত হয়েছে, যেটি CustomBiddingModelDetails অবজেক্টের একটি তালিকার মাধ্যমে অ্যাক্সেস আছে এমন প্রতিটি বিজ্ঞাপনদাতার জন্য বিদ্যমান অ্যালগরিদম মডেলের প্রস্তুতি এবং সাসপেনশন অবস্থা প্রদান করে।

অতিরিক্ত পরিবর্তন

উপরে তালিকাভুক্ত ব্রেকিং পরিবর্তনগুলি ছাড়াও, v2 নতুন বৈশিষ্ট্যগুলিও প্রবর্তন করে।

প্রারম্ভিক লঞ্চের পরে v2-তে যুক্ত বৈশিষ্ট্যগুলি আমাদের রিলিজ নোটগুলিতে পাওয়া যাবে।

YouTube লাইন আইটেমগুলিতে শুধুমাত্র-পঠন অ্যাক্সেস৷

v2-এ, YouTube লাইন আইটেম এবং তাদের টার্গেটিং সেটিংস যথাক্রমে advertisers.lineItems এবং advertisers.lineItems.targetingTypes.assignedTargetingOptions পরিষেবাগুলি ব্যবহার করে পুনরুদ্ধার করা যেতে পারে। এপিআই শুধুমাত্র পঠনযোগ্য অ্যাক্সেস প্রদান করে, যার অর্থ এই লাইন আইটেমগুলিতে করা যেকোনো লেখার অনুরোধ একটি ত্রুটি ফিরিয়ে দেবে। YouTube লাইন আইটেমগুলি নিম্নলিখিত LineItemType মানগুলির মধ্যে একটি হবে:

উন্নত কর্মক্ষমতা সক্ষম নতুন পদ্ধতি

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