একটি নতুন সংস্করণে স্থানান্তর করুন৷

ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই-এর নতুন সংস্করণ নিয়মিতভাবে প্রকাশিত হয়। নতুন সংস্করণ প্রকাশের সাথে সাথে, পূর্ববর্তী সংস্করণগুলি বন্ধ হয়ে যায় এবং অবশেষে অদৃশ্য হয়ে যায়। যখন কোনও সংস্করণ অদৃশ্য হয়ে যায়, তখন সেই সংস্করণের বিরুদ্ধে সমস্ত অনুরোধ ত্রুটি ফেরত দিতে শুরু করে।

যদি আপনার ব্যবহৃত সংস্করণটি বন্ধ হয়ে যায়, তাহলে পরিষেবা ব্যাহত না হওয়ার জন্য আপনাকে যত তাড়াতাড়ি সম্ভব আপগ্রেড করতে হবে।

ধাপ ১: আপনি কোন সংস্করণটি ব্যবহার করছেন তা নির্ধারণ করুন

আপনি নিম্নলিখিত নির্দেশাবলী অনুসরণ করে কোন API সংস্করণটি ব্যবহার করছেন তা নির্ধারণ করতে পারেন। বেশিরভাগ ক্ষেত্রে, আপনি আমাদের ভাষা-নির্দিষ্ট ক্লায়েন্ট লাইব্রেরি বা একটি অফিসিয়াল ইন্টিগ্রেশন ব্যবহার করে API অ্যাক্সেস করবেন।

অ্যাপস স্ক্রিপ্টের নতুন সম্পাদক

অ্যাপস স্ক্রিপ্টের সংস্করণ তথ্য উন্নত পরিষেবা সংলাপে প্রকাশিত হয়েছে:

  1. অ্যাপস স্ক্রিপ্ট এডিটর থেকে, একটি পরিষেবা করুন ক্লিক করুন।
  2. উপলব্ধ পরিষেবার তালিকায় ক্যাম্পেইন ম্যানেজার 360 API খুঁজে বের করুন।
  3. ভার্সন ড্রপ-ডাউনে নির্বাচিত মানটি হল ব্যবহৃত ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই ভার্সন।

অ্যাপস স্ক্রিপ্ট লিগ্যাসি এডিটর

অ্যাপস স্ক্রিপ্টের সংস্করণ তথ্য উন্নত পরিষেবা সংলাপে প্রকাশিত হয়েছে:

  1. অ্যাপস স্ক্রিপ্ট এডিটর থেকে, রিসোর্স > অ্যাডভান্সড গুগল সার্ভিসেস এ যান।
  2. উপলব্ধ পরিষেবার তালিকায় ক্যাম্পেইন ম্যানেজার 360 API খুঁজে বের করুন।
  3. ভার্সন ড্রপ-ডাউনে নির্বাচিত মানটি হল ব্যবহৃত ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই ভার্সন।

সি#

.NET-এর জন্য Google API ক্লায়েন্ট লাইব্রেরির সংস্করণ তথ্য নিম্নলিখিত স্থানে প্রকাশ করা হয়েছে:

  1. NuGet প্যাকেজের নাম এবং পরিষেবার নামস্থানে অন্তর্ভুক্ত।
    Google.Apis.Dfareporting.v3_4
  2. DfareportingService এর একটি পাবলিক সম্পত্তি ব্যবহার করে প্রকাশ করা হয়েছে।
    Console.WriteLine(DfareportingService.Version);

জাভা

জাভার জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরির সংস্করণ তথ্য নিম্নলিখিত স্থানে প্রকাশিত হয়েছে:

  1. Maven artifactId-তে উল্লেখ করা হয়েছে।
    <dependency> <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-dfareporting</artifactId>
    <version>v3.4-rev1-1.21.0</version>
    </dependency>
  2. JAR ফাইলের নামের মধ্যে অন্তর্ভুক্ত।
    google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
  3. 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 ক্লায়েন্ট লাইব্রেরি (v1/v2) সংস্করণ করা হয়নি। ব্যবহার করার জন্য API সংস্করণটি আবিষ্কার নির্মাতার কাছে একটি যুক্তি হিসাবে নির্দিষ্ট করা হয়েছে:

discovery.build('dfareporting', 'v3.4', http=http)

রুবি

রুবি ভার্সনের জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরি < 0.9 সংস্করণগুলি ভার্সন করা হয়নি। ব্যবহার করার জন্য এপিআই ভার্সনটি সার্ভিস কনস্ট্রাক্টরের কাছে একটি আর্গুমেন্ট হিসাবে নির্দিষ্ট করা হয়েছে:

service = Google::APIClient::Service.new("dfareporting", "v3.4", { :application_name => "My application",
:application_version => '1.0.0', :authorization => authorization } )

রুবি সংস্করণ >= 0.9 এর জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরির জন্য, সংস্করণটি পরিষেবা নেমস্পেসে প্রকাশিত হয়:

Google.Apis.DfareportingV3_4

ধাপ ২: আপনার সংস্করণের অবস্থা নির্ধারণ করুন

আপনার ভার্সনের অবস্থা নির্ধারণ করতে বন্ধ করার সময়সূচীটি পরীক্ষা করুন। যদি আপনার ভার্সনটি তালিকাভুক্ত না থাকে, তাহলে বুঝতে হবে এটি বন্ধ হয়ে গেছে এবং আর সমর্থিত নয়।

যদি আপনার সংস্করণটি তালিকাভুক্ত থাকে, তাহলে অবচয় তারিখ এবং সূর্যাস্ত তারিখ কলামগুলি পরীক্ষা করুন:

  • যদি কোন তারিখ না থাকে, তাহলে আপনার সংস্করণটি সম্পূর্ণরূপে সমর্থিত।
  • যদি তারিখগুলি উপস্থিত থাকে, তাহলে আপনার সংস্করণটি অপ্রচলিত হবে এবং নির্দিষ্ট তারিখে এটি সূর্যাস্ত হবে।

যদি আপনার সংস্করণটি বন্ধ হয়ে যায় অথবা অদৃশ্য হয়ে যায়, তাহলে পরিষেবার বাধা এড়াতে আপনাকে একটি নতুন সংস্করণে স্থানান্তর করতে হবে। আপগ্রেডের মধ্যে সর্বাধিক সময়সীমা বাড়ানোর জন্য আমরা সময়সূচীতে দেখানো (বিটা রিলিজ ব্যতীত) সাম্প্রতিকতম সংস্করণে স্থানান্তর করার পরামর্শ দিচ্ছি।

ধাপ ৩: সংস্করণগুলি আপগ্রেড করুন

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

অ্যাপস স্ক্রিপ্টের নতুন সম্পাদক

Google Apps Script Campaign Manager 360 API-এর সকল সংস্করণ সমর্থন করে এবং আপনাকে স্ক্রিপ্ট-বাই-স্ক্রিপ্ট ভিত্তিতে ব্যবহারের জন্য সংস্করণ নির্বাচন করতে দেয়। একটি নির্দিষ্ট স্ক্রিপ্ট দ্বারা ব্যবহৃত সংস্করণ পরিবর্তন করতে:

  1. অ্যাপস স্ক্রিপ্ট এডিটর থেকে, একটি পরিষেবা করুন ক্লিক করুন।
  2. উপলব্ধ পরিষেবার তালিকায় ক্যাম্পেইন ম্যানেজার 360 API খুঁজে বের করুন।
  3. ভার্সন ড্রপ-ডাউন ব্যবহার করে ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই ভার্সন পরিবর্তন করুন।
  4. আপনার পরিবর্তনগুলি সংরক্ষণ করতে যোগ করুন ক্লিক করুন।

অ্যাপস স্ক্রিপ্ট লিগ্যাসি এডিটর

Google Apps Script Campaign Manager 360 API-এর সকল সংস্করণ সমর্থন করে এবং আপনাকে স্ক্রিপ্ট-বাই-স্ক্রিপ্ট ভিত্তিতে ব্যবহারের জন্য সংস্করণ নির্বাচন করতে দেয়। একটি নির্দিষ্ট স্ক্রিপ্ট দ্বারা ব্যবহৃত সংস্করণ পরিবর্তন করতে:

  1. অ্যাপস স্ক্রিপ্ট এডিটর থেকে, রিসোর্স > অ্যাডভান্সড গুগল সার্ভিসেস এ যান।
  2. উপলব্ধ পরিষেবার তালিকায় ক্যাম্পেইন ম্যানেজার 360 API খুঁজে বের করুন।
  3. ভার্সন ড্রপ-ডাউন ব্যবহার করে ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই ভার্সন পরিবর্তন করুন।
  4. আপনার পরিবর্তনগুলি সংরক্ষণ করতে ঠিক আছে ক্লিক করুন।

সি#

.NET-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি ক্যাম্পেইন ম্যানেজার 360 API-এর প্রতিটি সংস্করণের জন্য আলাদা আলাদা বিল্ড প্রদান করে, যা NuGet-এর মাধ্যমে বিতরণ করা হয়। ক্লায়েন্ট লাইব্রেরির এমন একটি সংস্করণে আপডেট করুন যা আপনি যে API সংস্করণটি ব্যবহার করতে চান তার সাথে সঙ্গতিপূর্ণ।

বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড বিকল্পগুলির জন্য, ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন দেখুন।

জাভা

জাভার জন্য গুগল এপিআই ক্লায়েন্ট লাইব্রেরি ম্যাভেনের মাধ্যমে বিতরণ করা ক্যাম্পেইন ম্যানেজার ৩৬০ এপিআই-এর প্রতিটি সংস্করণের জন্য আলাদা আলাদা বিল্ড প্রদান করে। ক্লায়েন্ট লাইব্রেরির এমন একটি সংস্করণে আপডেট করুন যা আপনি যে এপিআই সংস্করণটি ব্যবহার করতে চান তার সাথে সঙ্গতিপূর্ণ।

বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড বিকল্পগুলির জন্য, ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন দেখুন।

পিএইচপি

PHP-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি ক্যাম্পেইন ম্যানেজার 360 API-এর প্রতিটি সংস্করণের জন্য আলাদা আলাদা বিল্ড প্রদান করে, যা Packagist-এর মাধ্যমে বিতরণ করা হয়। ক্লায়েন্ট লাইব্রেরির এমন একটি সংস্করণে আপডেট করুন যা আপনি যে API সংস্করণটি ব্যবহার করতে চান তার সাথে সঙ্গতিপূর্ণ।

বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড বিকল্পগুলির জন্য, ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন দেখুন।

পাইথন

পাইথনের জন্য Google API ক্লায়েন্ট লাইব্রেরির প্রতিটি বিল্ড (v1/v2) ক্যাম্পেইন ম্যানেজার 360 API-এর সকল সংস্করণ সমর্থন করে। ক্যাম্পেইন ম্যানেজার 360 API-এর একটি নতুন সংস্করণে মাইগ্রেট করতে, ডিসকভারি বিল্ডারের কাছে আর্গুমেন্ট হিসেবে পাস করা সংস্করণ স্ট্রিংটি আপডেট করুন:

discovery.build('dfareporting', 'v3.4', http=http)
বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড বিকল্পগুলির জন্য, ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন দেখুন।

রুবি

Ruby v0.8 এবং তার নিচের ভার্সনের জন্য Google API ক্লায়েন্ট লাইব্রেরি Campaign Manager 360 API-এর সকল ভার্সন সমর্থন করে। Campaign Manager 360 API-এর একটি নতুন ভার্সনে মাইগ্রেট করতে, পরিষেবা কনস্ট্রাক্টরে আর্গুমেন্ট হিসেবে পাস করা ভার্সন স্ট্রিংটি আপডেট করুন:

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
Ruby v0.9+ এর জন্য Google API ক্লায়েন্ট লাইব্রেরি Campaign Manager 360 API এর প্রতিটি সংস্করণের জন্য আলাদা আলাদা বিল্ড প্রদান করে, যা RubyGems এর মাধ্যমে বিতরণ করা হয়। ক্লায়েন্ট লাইব্রেরির এমন একটি সংস্করণে আপডেট করুন যা আপনি যে API সংস্করণটি ব্যবহার করতে চান তার সাথে সঙ্গতিপূর্ণ। বিস্তারিত ইনস্টলেশন নির্দেশাবলী বা বিকল্প ডাউনলোড বিকল্পগুলির জন্য, ক্লায়েন্ট লাইব্রেরি ডকুমেন্টেশন দেখুন।

বিশ্রাম

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

উদাহরণস্বরূপ, v4 থেকে v5 এ স্থানান্তর করার সময়, আপনাকে বেস URLটি এখান থেকে পরিবর্তন করতে হবে:

https://dfareporting.googleapis.com/dfareporting/v4/...
থেকে:
https://dfareporting.googleapis.com/dfareporting/v5/...

ধাপ ৪: সংস্করণের পার্থক্যগুলি চিহ্নিত করুন

নতুন API সংস্করণগুলি যখনই সম্ভব ব্যাকওয়ার্ড সামঞ্জস্যপূর্ণ করার জন্য ডিজাইন করা হয়েছে। তবে, কিছু আপডেটে ব্রেকিং পরিবর্তন অন্তর্ভুক্ত থাকতে পারে যার জন্য আপনাকে আপনার কোড পরিবর্তন করতে হবে। এই পরিবর্তনগুলি রিলিজ নোটে বিস্তারিতভাবে বর্ণনা করা হয়েছে।

মাইগ্রেট করার সময়, আপনার বর্তমান সংস্করণ এবং আপনি যে সংস্করণে আপগ্রেড করছেন তার মধ্যে প্রতিটি সংস্করণের জন্য রিলিজ নোটগুলি পর্যালোচনা করুন। নিম্নলিখিত বিভাগগুলিতে বিশেষ মনোযোগ দিন:

  • নতুন বৈশিষ্ট্য : নতুন যোগ করা কার্যকারিতা। মাইগ্রেশনের জন্য কোড পরিবর্তনের প্রয়োজন হয় না।
  • সূর্যাস্ত : API থেকে কার্যকারিতা সরানো হয়েছে। উপলব্ধ থাকলে প্রতিস্থাপন কার্যকারিতা উল্লেখ করা হয়।
  • জ্ঞাত সমস্যা : বিদ্যমান কার্যকারিতার পরিবর্তন, যেমন ক্ষেত্র বা পদ্ধতির নাম পরিবর্তন করা, অথবা পরিবর্তিত বৈধতা যুক্তি।

যদি আপনার অ্যাপ্লিকেশনটি "সানসেটস" বা "জ্ঞাত সমস্যা" বিভাগে তালিকাভুক্ত কার্যকারিতা ব্যবহার করে, তাহলে এই পরিবর্তনগুলি মোকাবেলা করার জন্য আপনাকে আপনার কোড আপডেট করতে হবে।

অবগত থাকুন

API রিলিজ, অবচয় এবং সূর্যাস্ত সম্পর্কে সবার আগে জানতে নিয়মিত Google Ads ডেভেলপার ব্লগটি পর্যবেক্ষণ করুন।