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-এর আপনার বিদ্যমান ব্যবহারের সাথে প্রাসঙ্গিক প্রয়োজনীয় পরিবর্তনগুলি করুন৷

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

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