ক্যাম্পেইন ম্যানেজার 360 API-এর নতুন সংস্করণ নিয়মিত প্রকাশিত হয়। নতুন সংস্করণ প্রকাশের সাথে সাথে, পুরানো সংস্করণগুলি অবমূল্যায়িত হয় এবং অবশেষে সূর্যাস্ত হয়। যখন একটি সংস্করণ সূর্যাস্ত হয়, সেই সংস্করণের বিরুদ্ধে সমস্ত অনুরোধ ত্রুটিগুলি ফেরত দিতে শুরু করে৷
আপনি যে APIটি ব্যবহার করছেন সেটির একটি সংস্করণ যদি অবহেলিত হয়, তাহলে আপনাকে নির্ধারিত সূর্যাস্তের তারিখের আগে একটি নতুন সংস্করণে স্থানান্তর করতে হবে। আপনি যে API সংস্করণটি ব্যবহার করছেন সেটি অবহেলিত হয়েছে কিনা তা নির্ধারণ করতে এই নির্দেশিকাটি বিশদ প্রদান করে এবং প্রস্তাবিত স্থানান্তর পদক্ষেপগুলি প্রদান করে।
ধাপ 1: আপনি কোন সংস্করণ ব্যবহার করছেন তা নির্ধারণ করুন
আপনি যদি ক্যাম্পেইন ম্যানেজার 360 এপিআই-এর একটি বাতিল সংস্করণ ব্যবহার করছেন বলে আপনার সন্দেহ হয় এমন একটি অ্যাপ্লিকেশন বজায় রাখা হয়, তাহলে প্রথমে আপনি কোন নির্দিষ্ট সংস্করণটি ব্যবহার করছেন তা যাচাই করা উচিত। বেশিরভাগ ক্ষেত্রে, আপনি আমাদের ভাষা-নির্দিষ্ট ক্লায়েন্ট লাইব্রেরি বা একটি অফিসিয়াল ইন্টিগ্রেশনের মাধ্যমে API অ্যাক্সেস করবেন। এই ক্লায়েন্ট লাইব্রেরি এবং ইন্টিগ্রেশন দ্বারা ব্যবহৃত API সংস্করণ খোঁজার জন্য নির্দেশাবলী নীচে পাওয়া যাবে:
অ্যাপস স্ক্রিপ্ট নতুন সম্পাদক
অ্যাপস স্ক্রিপ্টের সংস্করণ তথ্য উন্নত পরিষেবা সংলাপে প্রকাশ করা হয়েছে:
- অ্যাপস স্ক্রিপ্ট সম্পাদক থেকে, একটি পরিষেবা করুন ক্লিক করুন।
- উপলব্ধ পরিষেবার তালিকায় ক্যাম্পেইন ম্যানেজার 360 এপিআই খুঁজুন।
- সংস্করণ ড্রপডাউনে নির্বাচিত মানটি হল ক্যাম্পেইন ম্যানেজার 360 এপিআই সংস্করণ যা বর্তমানে ব্যবহৃত হচ্ছে৷
Apps স্ক্রিপ্ট উত্তরাধিকার সম্পাদক
অ্যাপস স্ক্রিপ্টের সংস্করণ তথ্য উন্নত পরিষেবা সংলাপে প্রকাশ করা হয়েছে:
- অ্যাপস স্ক্রিপ্ট সম্পাদক থেকে, সম্পদ > উন্নত Google পরিষেবাগুলিতে নেভিগেট করুন।
- উপলব্ধ পরিষেবার তালিকায় ক্যাম্পেইন ম্যানেজার 360 এপিআই খুঁজুন।
- সংস্করণ ড্রপডাউনে নির্বাচিত মানটি হল ক্যাম্পেইন ম্যানেজার 360 এপিআই সংস্করণ যা বর্তমানে ব্যবহৃত হচ্ছে৷
সি#
.NET-এর জন্য Google API ক্লায়েন্ট লাইব্রেরির সংস্করণ তথ্য নিম্নলিখিত জায়গায় প্রকাশ করা হয়েছে:
- নুগেট প্যাকেজের নাম এবং পরিষেবার নামস্থানে অন্তর্ভুক্ত।
Google.Apis.Dfareporting.v3_4
DfareportingService
এর একটি পাবলিক সম্পত্তির মাধ্যমে প্রকাশ করা হয়েছে৷Console.WriteLine(DfareportingService.Version);
জাভা
জাভার জন্য Google API ক্লায়েন্ট লাইব্রেরির সংস্করণ তথ্য নিম্নলিখিত জায়গায় উন্মুক্ত করা হয়েছে:
- ম্যাভেন আর্টিফ্যাক্টআইডিতে উল্লেখ করা হয়েছে।
<dependency> <groupId>com.google.apis</groupId> <artifactId>google-api-services-dfareporting</artifactId> <version>v3.4-rev1-1.21.0</version> </dependency>
- JAR ফাইলের নাম অন্তর্ভুক্ত.
google-api-services-dfareporting-v3.4-rev1-1.21.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;
পাইথন
পাইথনের জন্য Google API ক্লায়েন্ট লাইব্রেরি সংস্করণ করা হয়নি। ব্যবহার করার জন্য API সংস্করণটি আবিষ্কার নির্মাতার কাছে একটি যুক্তি হিসাবে নির্দিষ্ট করা হয়েছে:
discovery.build('dfareporting', 'v3.4', http=http)
রুবি
রুবি সংস্করণ < 0.9 এর জন্য Google API ক্লায়েন্ট লাইব্রেরি সংস্করণ করা হয় না। ব্যবহার করার জন্য API সংস্করণ পরিষেবা কনস্ট্রাক্টরের একটি যুক্তি হিসাবে নির্দিষ্ট করা হয়েছে:
service = Google::APIClient::Service.new("dfareporting", "v3.4", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
রুবি সংস্করণের জন্য Google API ক্লায়েন্ট লাইব্রেরির জন্য >= 0.9, সংস্করণটি পরিষেবার নামস্থানে উন্মুক্ত করা হয়েছে:
Google.Apis.DfareportingV3_4
আপনি যে সংস্করণটি ব্যবহার করছেন তা নোট করুন, কারণ পরে আপনার এই তথ্যের প্রয়োজন হবে।
ধাপ 2: আপনার সংস্করণের স্থিতি নির্ধারণ করুন
অবচয় সূচি বর্তমানে সমর্থিত প্রতিটি সংস্করণের স্থিতি তালিকাভুক্ত করে। এই তালিকায় আপনার সংস্করণ খুঁজুন এবং নিম্নরূপ এর স্থিতি নির্ধারণ করুন:
- অবচয় তারিখ এবং সূর্যাস্তের তারিখ কলামে তালিকাভুক্ত কোনো তারিখ না থাকলে, আপনি একটি সম্পূর্ণ সমর্থিত সংস্করণ ব্যবহার করছেন।
- যদি তারিখগুলি তালিকাভুক্ত করা হয়, আপনি যে সংস্করণটি ব্যবহার করছেন তা বর্তমানে বাতিল করা হয়েছে এবং নির্দিষ্ট তারিখে সূর্যাস্ত হবে৷
- আপনার সংস্করণ তালিকাভুক্ত না হলে, এটি ইতিমধ্যেই সূর্যাস্ত হয়েছে এবং আর সমর্থিত নয়৷
আপনি যদি উপরের #2 বা #3 তে পড়েন, তাহলে পরিষেবাতে বাধা এড়াতে আপনাকে একটি নতুন সংস্করণে স্থানান্তর করতে হবে। এটি সুপারিশ করা হয় যে আপনি সাম্প্রতিকতম সংস্করণে স্থানান্তর করুন, যা অবচয় সময়সূচী টেবিলের শীর্ষে তালিকাভুক্ত করা হয়েছে (বিটা রিলিজগুলি ব্যতীত)৷ এটি আপনাকে আপগ্রেডের মধ্যে সর্বাধিক সময় বহন করবে।
ধাপ 3: সংস্করণ আপগ্রেড করুন
আপনি যদি স্থির করে থাকেন যে আপনাকে স্থানান্তর করতে হবে, তাহলে পরবর্তী ধাপ হল আপনার ইন্টিগ্রেশন আপডেট করা বা আপনার পছন্দের ক্লায়েন্ট লাইব্রেরির একটি আপডেট করা বিল্ড প্রাপ্ত করা। মনে রাখবেন যে কিছু ক্লায়েন্ট লাইব্রেরি শুধুমাত্র একটি একক বিল্ড প্রদান করতে পারে যা যেকোনো API সংস্করণের সাথে কাজ করে, অন্যদের প্রতিটি সংস্করণের জন্য পৃথক বিল্ড থাকবে। নীচের তালিকাটি সর্বাধিক ব্যবহৃত ক্লায়েন্ট লাইব্রেরি এবং একীকরণের জন্য সাধারণ আপগ্রেড তথ্য প্রদান করে।
অ্যাপস স্ক্রিপ্ট নতুন সম্পাদক
Google Apps স্ক্রিপ্ট ক্যাম্পেইন ম্যানেজার 360 API-এর সমস্ত সংস্করণ সমর্থন করে এবং আপনাকে স্ক্রিপ্ট-বাই-স্ক্রিপ্ট ভিত্তিতে ব্যবহার করার জন্য সংস্করণ নির্বাচন করার অনুমতি দেয়। একটি নির্দিষ্ট স্ক্রিপ্ট দ্বারা ব্যবহৃত সংস্করণ পরিবর্তন করতে:
- অ্যাপস স্ক্রিপ্ট সম্পাদক থেকে, একটি পরিষেবা করুন ক্লিক করুন।
- উপলব্ধ পরিষেবার তালিকায় ক্যাম্পেইন ম্যানেজার 360 এপিআই খুঁজুন।
- সংস্করণ ড্রপডাউনের মাধ্যমে ব্যবহার করা ক্যাম্পেইন ম্যানেজার 360 API সংস্করণ পরিবর্তন করুন।
- আপনার পরিবর্তন সংরক্ষণ করতে যোগ করুন ক্লিক করুন.
Apps স্ক্রিপ্ট উত্তরাধিকার সম্পাদক
Google Apps স্ক্রিপ্ট ক্যাম্পেইন ম্যানেজার 360 API-এর সমস্ত সংস্করণ সমর্থন করে এবং আপনাকে স্ক্রিপ্ট-বাই-স্ক্রিপ্ট ভিত্তিতে ব্যবহার করার জন্য সংস্করণ নির্বাচন করার অনুমতি দেয়। একটি নির্দিষ্ট স্ক্রিপ্ট দ্বারা ব্যবহৃত সংস্করণ পরিবর্তন করতে:
- অ্যাপস স্ক্রিপ্ট সম্পাদক থেকে, সম্পদ > উন্নত Google পরিষেবাগুলিতে নেভিগেট করুন।
- উপলব্ধ পরিষেবার তালিকায় ক্যাম্পেইন ম্যানেজার 360 এপিআই খুঁজুন।
- সংস্করণ ড্রপডাউনের মাধ্যমে ব্যবহার করা ক্যাম্পেইন ম্যানেজার 360 API সংস্করণ পরিবর্তন করুন।
- আপনার পরিবর্তন সংরক্ষণ করতে ঠিক আছে ক্লিক করুন.
সি#
.NET-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি ক্যাম্পেইন ম্যানেজার 360 API-এর প্রতিটি সংস্করণের জন্য আলাদা বিল্ড সরবরাহ করে, Nuget এর মাধ্যমে বিতরণ করা হয়।
বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড বিকল্পের জন্য, ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন পড়ুন।
জাভা
জাভার জন্য Google API ক্লায়েন্ট লাইব্রেরি ক্যাম্পেইন ম্যানেজার 360 API-এর প্রতিটি সংস্করণের জন্য আলাদা বিল্ড প্রদান করে, যা Maven এর মাধ্যমে বিতরণ করা হয়।
বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড বিকল্পের জন্য, ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন পড়ুন।
পিএইচপি
PHP-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি প্যাকেজিস্টের মাধ্যমে বিতরণ করা ক্যাম্পেইন ম্যানেজার 360 API-এর প্রতিটি সংস্করণের জন্য আলাদা বিল্ড প্রদান করে।
বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড বিকল্পের জন্য, ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন পড়ুন।
পাইথন
Python-এর জন্য Google API ক্লায়েন্ট লাইব্রেরির প্রতিটি বিল্ড ক্যাম্পেইন ম্যানেজার 360 API-এর সমস্ত সংস্করণ সমর্থন করে। আবিষ্কার নির্মাতার কাছে একটি যুক্তি হিসাবে পাস করা সংস্করণ স্ট্রিংটি কেবল আপডেট করুন:
discovery.build('dfareporting', 'v3.4', http=http)
রুবি
Ruby v0.8 এবং তার নিচের জন্য Google API ক্লায়েন্ট লাইব্রেরি ক্যাম্পেইন ম্যানেজার 360 API-এর সমস্ত সংস্করণ সমর্থন করে। পরিষেবা কনস্ট্রাক্টরের কাছে একটি যুক্তি হিসাবে পাস করা সংস্করণ স্ট্রিংটি কেবল আপডেট করুন:
service = Google::APIClient::Service.new("dfareporting", "v3.4", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
ধাপ 4: ঠিকানা সংস্করণ পার্থক্য
আমরা আমাদের নতুন রিলিজগুলিকে পিছনের দিকে সামঞ্জস্যপূর্ণ করার চেষ্টা করি, যার অর্থ হল API সংস্করণগুলির মধ্যে স্থানান্তরিত করার জন্য আপনার কোডে পরিবর্তনের প্রয়োজন হবে না৷ যখন এটি সম্ভব না হয়, তখন আমরা আমাদের রিলিজ নোটগুলিতে বিকাশকারীদের ( ব্রেকিং চেঞ্জ নামেও পরিচিত) থেকে পদক্ষেপের প্রয়োজন হয় এমন পরিবর্তনগুলি ঘোষণা করি৷
এই মুহুর্তে, আপনার আমাদের রিলিজ নোটগুলি পর্যালোচনা করা উচিত, আপনি যে সংস্করণ থেকে শুরু করেছিলেন তার পরের সংস্করণটি দিয়ে শুরু করুন (যেটি আপনি পূর্ববর্তী বিভাগে একটি নোট করেছেন) এবং আপনি যে সংস্করণটি আপগ্রেড করছেন তা সহ চালিয়ে যাওয়া। রিলিজ নোটের বিভাগগুলি নিম্নরূপ ব্যাখ্যা করা উচিত:
- নতুন বৈশিষ্ট্য - নতুন যুক্ত কার্যকারিতা।
- সানসেট - কার্যকারিতা যা API থেকে সরানো হয়েছে। যখন উপলব্ধ, প্রতিস্থাপন কার্যকারিতা এই বিভাগে আচ্ছাদিত করা হবে.
- পরিচিত সমস্যা - পরিবর্তন যা সংযোজন বা অপসারণ নয়। উদাহরণস্বরূপ, এই বিভাগটি ক্ষেত্র বা পদ্ধতিগুলিকে কভার করতে পারে যেগুলির নাম পরিবর্তন করা হয়েছে, বা বৈধকরণ যুক্তি যা পরিবর্তিত হয়েছে৷
নতুন বৈশিষ্ট্যের কার্যকারিতার জন্য কোড পরিবর্তনের প্রয়োজন হবে না এবং আপাতত উপেক্ষা করা যেতে পারে। আপনি যদি আমাদের যোগ করা কিছু নিয়ে পরীক্ষা করতে চান তাহলে নির্দ্বিধায় পরে এই বিভাগে ফিরে আসুন।
আপনি যদি সানসেট বা পরিচিত সমস্যা বিভাগে পরিবর্তন খুঁজে পান, অন্যদিকে, আপনাকে ব্যবস্থা নিতে হতে পারে। আপনার অ্যাপ্লিকেশন দ্বারা সরানো বা পরিবর্তিত কার্যকারিতা ব্যবহার করা হয়েছে কিনা তা নির্ধারণ করতে আপনার কোডের মাধ্যমে অনুসন্ধান করা উচিত। যদি তাই হয়, তাহলে এই পরিবর্তনগুলি মোকাবেলা করার জন্য আপনাকে আপনার কোডে আপডেট করতে হবে৷
অবগত থাকুন
আগেই উল্লেখ করা হয়েছে, ক্যাম্পেইন ম্যানেজার 360 API রিলিজ এবং সূর্যাস্ত নিয়মিত হয়। নতুন রিলিজ, অবচয়, এবং সূর্যাস্ত সম্পর্কে আপডেটগুলি নিম্নলিখিত চ্যানেলগুলিতে পোস্ট করা হয়েছে:
- Google বিজ্ঞাপন বিকাশকারী ব্লগ ( ইমেল সতর্কতার জন্য সদস্যতা নিন )
- ক্যাম্পেইন ম্যানেজার 360 API ফোরাম
সর্বশেষ API খবরের সাথে আপ-টু-ডেট থাকার জন্য আপনি এই চ্যানেলগুলির এক বা একাধিক সাবস্ক্রাইব করার পরামর্শ দেওয়া হচ্ছে।