ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই-এর নতুন সংস্করণ নিয়মিতভাবে প্রকাশ করা হয়। নতুন সংস্করণ প্রকাশিত হওয়ার সাথে সাথে, পূর্ববর্তী সংস্করণগুলো অপ্রচলিত হয়ে যায় এবং অবশেষে বন্ধ হয়ে যায়। যখন কোনো সংস্করণ বন্ধ হয়ে যায়, তখন সেই সংস্করণের বিরুদ্ধে করা সমস্ত অনুরোধ ত্রুটি দেখাতে শুরু করে।
আপনি যে সংস্করণটি ব্যবহার করছেন তা যদি অপ্রচলিত হয়ে থাকে, তবে পরিষেবা বিঘ্নিত হওয়া এড়াতে আপনাকে যত দ্রুত সম্ভব আপগ্রেড করতে হবে।
ধাপ ১: আপনি কোন সংস্করণটি ব্যবহার করছেন তা নির্ধারণ করুন।
নিম্নলিখিত নির্দেশাবলী অনুসরণ করে আপনি কোন এপিআই সংস্করণ ব্যবহার করছেন তা নির্ধারণ করতে পারেন। বেশিরভাগ ক্ষেত্রে, আপনি আমাদের ভাষা-নির্দিষ্ট ক্লায়েন্ট লাইব্রেরি বা একটি অফিসিয়াল ইন্টিগ্রেশন ব্যবহার করে এপিআই অ্যাক্সেস করবেন।
অ্যাপস স্ক্রিপ্ট নতুন সম্পাদক
অ্যাপস স্ক্রিপ্টের সংস্করণ সংক্রান্ত তথ্য অ্যাডভান্সড সার্ভিসেস ডায়ালগে প্রদর্শিত হয়:
- অ্যাপস স্ক্রিপ্ট এডিটর থেকে, 'Add a service ক্লিক করুন।
- উপলব্ধ পরিষেবাগুলোর তালিকা থেকে ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই (Campaign Manager 360 API) খুঁজে বের করুন।
- ভার্সন ড্রপ-ডাউনে নির্বাচিত মানটি হলো ব্যবহৃত ক্যাম্পেইন ম্যানেজার 360 API ভার্সন।
অ্যাপস স্ক্রিপ্ট লিগ্যাসি এডিটর
অ্যাপস স্ক্রিপ্টের সংস্করণ সংক্রান্ত তথ্য অ্যাডভান্সড সার্ভিসেস ডায়ালগে প্রদর্শিত হয়:
- অ্যাপস স্ক্রিপ্ট এডিটর থেকে, রিসোর্সেস > অ্যাডভান্সড গুগল সার্ভিসেস- এ যান।
- উপলব্ধ পরিষেবাগুলোর তালিকা থেকে ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই (Campaign Manager 360 API) খুঁজে বের করুন।
- ভার্সন ড্রপ-ডাউনে নির্বাচিত মানটি হলো ব্যবহৃত ক্যাম্পেইন ম্যানেজার 360 API ভার্সন।
সি#
.NET-এর জন্য Google API ক্লায়েন্ট লাইব্রেরির সংস্করণ সম্পর্কিত তথ্য নিম্নলিখিত স্থানগুলিতে প্রকাশ করা হয়:
- NuGet প্যাকেজের নাম এবং সার্ভিস নেমস্পেসের অন্তর্ভুক্ত।
Google.Apis.Dfareporting.v5
DfareportingServiceএর একটি পাবলিক প্রপার্টি ব্যবহার করে উন্মুক্ত করা হয়েছে।Console.WriteLine(DfareportingService.Version);
জাভা
জাভার জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরির সংস্করণ সম্পর্কিত তথ্য নিম্নলিখিত স্থানগুলিতে প্রকাশ করা হয়েছে:
- Maven artifactId-তে নির্দিষ্ট করা আছে।
<dependency> <groupId>com.google.apis</groupId> <artifactId>google-api-services-dfareporting</artifactId> <version>v5-rev20260213-2.0.0</version> </dependency>
- JAR ফাইলের নামে অন্তর্ভুক্ত।
google-api-services-dfareporting-v5-rev20260213-2.0.0.jar
Dfareportingএর একটি পাবলিক প্রপার্টি ব্যবহার করে ফাঁস করা হয়েছে।System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);
পিএইচপি
PHP-এর জন্য Google API ক্লায়েন্ট লাইব্রেরির সংস্করণ তথ্য Google_Service_Dfareporting এর একটি পাবলিক প্রপার্টি ব্যবহার করে প্রকাশ করা হয়:
$service = new Google_Service_Dfareporting($client) print $service->version;
পাইথন
পাইথনের জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরি (v1/v2) সংস্করণযুক্ত নয়। কোন এপিআই সংস্করণটি ব্যবহার করতে হবে তা ডিসকভারি বিল্ডারের একটি আর্গুমেন্ট হিসাবে নির্দিষ্ট করা হয়:
discovery.build('dfareporting', 'v5', http=http)
রুবি
রুবি-র জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরির ০.৯-এর কম সংস্করণগুলিতে কোনো সংস্করণ নেই। কোন এপিআই সংস্করণটি ব্যবহার করতে হবে, তা সার্ভিস কনস্ট্রাক্টরের একটি আর্গুমেন্ট হিসেবে নির্দিষ্ট করা হয়:
service = Google::APIClient::Service.new("dfareporting", "v5", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
Google API Client Library for Ruby-এর >= 0.9 সংস্করণগুলির ক্ষেত্রে, সংস্করণটি সার্ভিস নেমস্পেসে প্রকাশ করা হয়:
Google.Apis.DfareportingV5
ধাপ ২: আপনার ভার্সনের অবস্থা নির্ধারণ করুন।
আপনার ভার্সনের অবস্থা জানতে ডেপ্রিকেশন শিডিউলটি দেখুন। যদি আপনার ভার্সনটি তালিকায় না থাকে, তার মানে হলো এটির পরিষেবা বন্ধ করে দেওয়া হয়েছে এবং এটি আর সমর্থিত নয়।
আপনার সংস্করণটি তালিকাভুক্ত থাকলে, Deprecation Date এবং Sunset Date কলামগুলি পরীক্ষা করুন:
- যদি কোনো তারিখ উল্লেখ না থাকে, তাহলে আপনার সংস্করণটি সম্পূর্ণরূপে সমর্থিত।
- যদি তারিখ উল্লেখ থাকে, তাহলে আপনার সংস্করণটি অপ্রচলিত এবং নির্দিষ্ট তারিখে এর ব্যবহার বন্ধ হয়ে যাবে।
আপনার সংস্করণটি যদি অপ্রচলিত বা বন্ধ হয়ে গিয়ে থাকে, তাহলে পরিষেবা বিঘ্ন এড়াতে আপনাকে একটি নতুন সংস্করণে স্থানান্তরিত হতে হবে। আপগ্রেডের মধ্যবর্তী সময় সর্বাধিক করার জন্য আমরা সময়সূচীতে দেখানো সর্বশেষ সংস্করণে (বিটা রিলিজ ব্যতীত) স্থানান্তরিত হওয়ার পরামর্শ দিই।
ধাপ ৩: সংস্করণ আপগ্রেড করুন
এপিআই-এর নতুন সংস্করণে স্থানান্তরিত হতে, আপনাকে আপনার ইন্টিগ্রেশন আপডেট করতে হবে অথবা আপনার পছন্দের ক্লায়েন্ট লাইব্রেরির একটি আপডেটেড বিল্ড সংগ্রহ করতে হবে। উল্লেখ্য যে, কিছু ক্লায়েন্ট লাইব্রেরি এমন একটি বিল্ড সরবরাহ করতে পারে যা যেকোনো এপিআই সংস্করণের সাথে কাজ করে, আবার অন্যগুলোর প্রতিটি সংস্করণের জন্য আলাদা বিল্ড থাকে। নিম্নলিখিত তালিকাটি সর্বাধিক ব্যবহৃত ক্লায়েন্ট লাইব্রেরি এবং ইন্টিগ্রেশনগুলির জন্য সাধারণ আপগ্রেড তথ্য প্রদান করে।
অ্যাপস স্ক্রিপ্ট নতুন সম্পাদক
গুগল অ্যাপস স্ক্রিপ্ট ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই-এর সকল সংস্করণ সমর্থন করে এবং আপনাকে প্রতিটি স্ক্রিপ্টের জন্য আলাদাভাবে ব্যবহারের সংস্করণ বেছে নেওয়ার সুযোগ দেয়। কোনো নির্দিষ্ট স্ক্রিপ্টের ব্যবহৃত সংস্করণ পরিবর্তন করতে:
- অ্যাপস স্ক্রিপ্ট এডিটর থেকে, 'Add a service ক্লিক করুন।
- উপলব্ধ পরিষেবাগুলোর তালিকা থেকে ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই (Campaign Manager 360 API) খুঁজে বের করুন।
- ভার্সন ড্রপ-ডাউন ব্যবহার করে ক্যাম্পেইন ম্যানেজার 360 API ভার্সন পরিবর্তন করুন।
- আপনার পরিবর্তনগুলি সংরক্ষণ করতে 'যোগ করুন' -এ ক্লিক করুন।
অ্যাপস স্ক্রিপ্ট লিগ্যাসি এডিটর
গুগল অ্যাপস স্ক্রিপ্ট ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই-এর সকল সংস্করণ সমর্থন করে এবং আপনাকে প্রতিটি স্ক্রিপ্টের জন্য আলাদাভাবে ব্যবহারের সংস্করণ বেছে নেওয়ার সুযোগ দেয়। কোনো নির্দিষ্ট স্ক্রিপ্টের ব্যবহৃত সংস্করণ পরিবর্তন করতে:
- অ্যাপস স্ক্রিপ্ট এডিটর থেকে, রিসোর্সেস > অ্যাডভান্সড গুগল সার্ভিসেস- এ যান।
- উপলব্ধ পরিষেবাগুলোর তালিকা থেকে ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই (Campaign Manager 360 API) খুঁজে বের করুন।
- ভার্সন ড্রপ-ডাউন ব্যবহার করে ক্যাম্পেইন ম্যানেজার 360 API ভার্সন পরিবর্তন করুন।
- আপনার পরিবর্তনগুলি সংরক্ষণ করতে OK ক্লিক করুন।
সি#
.NET-এর জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরিটি ক্যাম্পেইন ম্যানেজার 360 এপিআই-এর প্রতিটি সংস্করণের জন্য আলাদা বিল্ড প্রদান করে, যা NuGet-এর মাধ্যমে বিতরণ করা হয়। আপনি যে এপিআই সংস্করণটি ব্যবহার করতে চান, তার সাথে সামঞ্জস্যপূর্ণ ক্লায়েন্ট লাইব্রেরির সংস্করণে আপডেট করুন।
বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড অপশনের জন্য, ক্লায়েন্ট লাইব্রেরির ডকুমেন্টেশন দেখুন।
জাভা
জাভার জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরিটি ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই-এর প্রতিটি সংস্করণের জন্য আলাদা বিল্ড প্রদান করে, যা মেভেনের মাধ্যমে বিতরণ করা হয়। আপনি যে এপিআই সংস্করণটি ব্যবহার করতে চান, তার সাথে সামঞ্জস্যপূর্ণ ক্লায়েন্ট লাইব্রেরির সংস্করণে আপডেট করুন।
বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড অপশনের জন্য, ক্লায়েন্ট লাইব্রেরির ডকুমেন্টেশন দেখুন।
পিএইচপি
PHP-এর জন্য Google API ক্লায়েন্ট লাইব্রেরিটি Packagist-এর মাধ্যমে বিতরণ করা Campaign Manager 360 API-এর প্রতিটি সংস্করণের জন্য আলাদা বিল্ড প্রদান করে। আপনি যে API সংস্করণটি ব্যবহার করতে চান, তার সাথে সামঞ্জস্যপূর্ণ ক্লায়েন্ট লাইব্রেরির সংস্করণে আপডেট করুন।
বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড অপশনের জন্য, ক্লায়েন্ট লাইব্রেরির ডকুমেন্টেশন দেখুন।
পাইথন
পাইথনের জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরির (v1/v2) প্রতিটি বিল্ড ক্যাম্পেইন ম্যানেজার 360 এপিআই-এর সকল সংস্করণ সমর্থন করে। ক্যাম্পেইন ম্যানেজার 360 এপিআই-এর একটি নতুন সংস্করণে মাইগ্রেট করতে, ডিসকভারি বিল্ডারে আর্গুমেন্ট হিসেবে পাঠানো সংস্করণ স্ট্রিংটি আপডেট করুন:
discovery.build('dfareporting', 'v5', http=http)
রুবি
রুবি v0.8 এবং তার নিচের সংস্করণের জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরি ক্যাম্পেইন ম্যানেজার 360 এপিআই-এর সকল সংস্করণ সমর্থন করে। ক্যাম্পেইন ম্যানেজার 360 এপিআই-এর নতুন সংস্করণে মাইগ্রেট করতে, সার্ভিস কনস্ট্রাক্টরে আর্গুমেন্ট হিসেবে পাঠানো ভার্সন স্ট্রিংটি আপডেট করুন:
service = Google::APIClient::Service.new("dfareporting", "v5", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
বিশ্রাম
আপনি যদি HTTPS ব্যবহার করে সরাসরি এপিআই কল করেন, তাহলে আপনার অনুরোধগুলোর জন্য এন্ডপয়েন্টটি আপডেট করে নতুন এপিআই ভার্সন নম্বরটি ব্যবহার করুন।
উদাহরণস্বরূপ, v4 থেকে v5 এ স্থানান্তরিত করার সময়, আপনাকে বেস URL-টি পরিবর্তন করতে হবে:
https://dfareporting.googleapis.com/dfareporting/v4/...
https://dfareporting.googleapis.com/dfareporting/v5/...
ধাপ ৪: সংস্করণের পার্থক্যগুলো সমাধান করুন
নতুন API সংস্করণগুলো যথাসম্ভব পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যপূর্ণ (backward compatible) করে ডিজাইন করা হয়। তবে, কিছু আপডেটে এমন কিছু পরিবর্তন (breaking changes) থাকতে পারে যার জন্য আপনাকে আপনার কোড পরিবর্তন করতে হতে পারে। এই পরিবর্তনগুলো রিলিজ নোটে বিস্তারিতভাবে উল্লেখ করা থাকে।
মাইগ্রেট করার সময়, আপনার বর্তমান সংস্করণ এবং যে সংস্করণে আপগ্রেড করছেন তার মধ্যবর্তী প্রতিটি সংস্করণের রিলিজ নোট পর্যালোচনা করুন। নিম্নলিখিত বিভাগগুলিতে বিশেষ মনোযোগ দিন:
- নতুন বৈশিষ্ট্য : নতুনভাবে যুক্ত হওয়া কার্যকারিতা। মাইগ্রেশনের জন্য এগুলোর কোডে কোনো পরিবর্তনের প্রয়োজন নেই।
- সানসেটস : এপিআই থেকে কার্যকারিতাটি সরিয়ে ফেলা হয়েছে। এর বিকল্প কার্যকারিতা উপলব্ধ হলে তা উল্লেখ করা হয়।
- জ্ঞাত সমস্যাসমূহ : বিদ্যমান কার্যকারিতার পরিবর্তন, যেমন ফিল্ড বা মেথডের নাম পরিবর্তন, অথবা ভ্যালিডেশন লজিকের পরিবর্তন।
আপনার অ্যাপ্লিকেশনটি যদি সানসেটস বা নোন ইস্যুস বিভাগে তালিকাভুক্ত কোনো কার্যকারিতা ব্যবহার করে, তাহলে এই পরিবর্তনগুলো অন্তর্ভুক্ত করার জন্য আপনাকে আপনার কোড আপডেট করতে হবে।
অবগত থাকুন
এপিআই রিলিজ, ডেপ্রিকেশন এবং সানসেট সম্পর্কে সবার আগে জানতে নিয়মিত গুগল অ্যাডস ডেভেলপার ব্লগ পর্যবেক্ষণ করুন।