সর্বশেষ সংস্করণে আপগ্রেড করুন

পর্যায়ক্রমে, আপনি Google বিজ্ঞাপন API-এর একটি পুরানো প্রধান সংস্করণ থেকে একটি নতুন প্রধান সংস্করণে আপগ্রেড করতে চাইতে পারেন। এটি হতে পারে কারণ একটি সংস্করণ সূর্যাস্ত হচ্ছে, অথবা এটি হতে পারে কারণ আপনি একটি নতুন বৈশিষ্ট্য ব্যবহার করতে চান৷ আমরা সুপারিশ করি যে আপনি সর্বদা নতুন সংস্করণে আপগ্রেড করুন৷

আপনার আপগ্রেড পরিকল্পনা করতে আমাদের অবচয় সময়সূচী দেখুন. সংস্করণ কিভাবে কাজ করে তা জানতে আমাদের সংস্করণ নির্দেশিকা দেখুন।

আপগ্রেড করার প্রক্রিয়া শুরু করতে আপনাকে সাহায্য করার জন্য এখানে একটি চেকলিস্ট রয়েছে:

  1. আপনি যখন প্রধান সংস্করণ পরিবর্তন করবেন তখন আপনার এন্ডপয়েন্ট পরিবর্তন হবে। নতুন এন্ডপয়েন্ট ব্যবহার করতে আপনার ক্লায়েন্ট লাইব্রেরি আপডেট করুন।
  2. প্রতিটি রিলিজে প্রবর্তিত পরিবর্তনগুলি দেখতে রিলিজ নোটগুলির মাধ্যমে যান৷
  3. আপনি যে সংস্করণে আপগ্রেড করছেন তার জন্য নির্দিষ্ট ক্ষেত্রগুলিতে ফোকাস করার জন্য নীচের সারণীগুলি দেখুন৷

দুটি সংস্করণের প্রোটোর মধ্যে পার্থক্যের উপর ভিত্তি করে পরিবর্তনের একটি বিস্তৃত ওভারভিউয়ের জন্য, পার্থক্য টেবিলটি দেখুন।

v16 থেকে v17

পরিষেবা এবং তাদের উপাদান পরিবর্তন
GoogleAdsService Search এবং SearchStream অনুরোধ

আপনার অনুরোধ যখন থ্রোটল করা হয় কারণ এটি অত্যন্ত ব্যয়বহুল হয় তখন ত্রুটিটি হয় QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION বা QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION এর পরিবর্তে হবে। QuotaError.RESOURCE_EXHAUSTED আরো বিস্তারিত জানার জন্য ব্লগ পোস্ট দেখুন.

GoogleAdsService Search অনুরোধ.

GoogleAdsService.Search এ একটি page_size পাস করার ফলে একটি RequestError.PAGE_SIZE_NOT_SUPPORTED হবে।PAGE_SIZE_NOT_SUPPORTED ত্রুটি।

Campaign এবং Ad

DISCOVERY এর AdvertisingChannelType সহ প্রচারাভিযানে এখন DEMAND_GEN এর AdvertisingChannelType থাকবে৷

উপরন্তু, কিছু বিজ্ঞাপন রিপোর্ট করার জন্য ধরন এবং ক্ষেত্রের নাম পরিবর্তন করবে:

  • DISCOVERY_MULTI_ASSET_ADD হয়ে যাবে DEMAND_GEN_MULTI_ASSET_ADD এবং সংশ্লিষ্ট রিপোর্টিং ক্ষেত্র ad_group_ad.ad.discovery_multi_asset_ad হয়ে যাবে ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD হয়ে যাবে DEMAND_GEN_CAROUSEL_AD এবং সংশ্লিষ্ট রিপোর্টিং ক্ষেত্র ad_group_ad.ad.discovery_carousel_ad হয়ে যাবে ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD হয়ে যাবে DEMAND_GEN_VIDEO_RESPONSIVE_AD এবং সংশ্লিষ্ট রিপোর্টিং ফিল্ড ad_group_ad.ad.discovery_video_responsive_ad হয়ে যাবে ad_group_ad.ad.demand_gen_video_responsive_ad

AdService GetAd এন্ডপয়েন্ট সরানো হবে। এটি Google বিজ্ঞাপন API-এর অন্যান্য পরিষেবার সাথে সামঞ্জস্যপূর্ণ AdService নিয়ে আসে। বিজ্ঞাপন এবং অন্যান্য রিসোর্সের ধরন আনার প্রস্তাবিত উপায়ের জন্য বস্তু পুনরুদ্ধারের বিষয়ে আমাদের গাইড দেখুন।
CustomerLifecycleGoal এবং CampaignLifecycleGoal জীবনচক্রের লক্ষ্যগুলির জন্য আপনি যেভাবে বিভাগগুলি পরিচালনা করেন তা পুনরায় কাজ করা হয়। একটি সম্পূর্ণ সংক্ষিপ্ত বিবরণের জন্য জীবনচক্র লক্ষ্য ডকুমেন্টেশনের আপনার শ্রোতা বিভাগটি দেখুন।
ProductLink product_link জন্য একটি GoogleAdsService অনুসন্ধান বা অনুসন্ধান স্ট্রিম অনুরোধ চালানোর সময়, আপনি এখন শুধুমাত্র একটি লিঙ্ক করা পণ্যের সাথে সম্পর্কিত ক্ষেত্রগুলি নির্বাচন করতে পারেন৷ বিভিন্ন লিঙ্কযুক্ত পণ্য থেকে একাধিক ক্ষেত্র নির্বাচন করার ফলে একটি QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE দেখা দেবে৷ PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE ত্রুটি৷
রিপোর্টিং metrics.sk_ad_network_conversion_value ফিল্ডের নাম পরিবর্তন করে metrics.sk_ad_network_fine_conversion_value করা হয়েছে।

v15 থেকে v16

পরিষেবা এবং তাদের উপাদান পরিবর্তন
AccountLink linked_account data_partner এবং google_ads লিঙ্কগুলি সরানো হয়েছে। পরিবর্তে ProductLinkService এবং ProductLinkInvitationService ব্যবহার করুন।
CampaignLifecycleGoal পূর্বে একটি বিদ্যমান CampaignLifecycleGoal আপডেট করার সময়, আপনি নির্দিষ্ট প্রয়োজনীয়তার সাথে একটি create অপারেশন ইস্যু করবেন। এখন আপনি পরিবর্তে অন্যান্য রিসোর্স প্রকারের মতো একটি update অপারেশন ইস্যু করতে পারেন।
ভূল প্রতিবেদন দুটি ক্ষেত্রে যেখানে জেনেরিক ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT ত্রুটিটি ফেরত দেওয়া হয়েছিল এখন আরও নির্দিষ্ট ত্রুটির বার্তাগুলির ফলাফল:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata score ক্ষেত্র সরানো হয়েছে.
KeywordMatchTypeRecommendation যদি কীওয়ার্ড ম্যাচের ধরন সেট না করা থাকে, তাহলে API এখন recommended_match_type match_type ক্ষেত্রের জন্য UNKNOWN পরিবর্তে UNSPECIFIED প্রদান করে।