গুগল অ্যাডস স্ক্রিপ্টের উন্নত এপিআইগুলো ডেভেলপারদেরকে তাদের এইচটিটিপি ইন্টারফেস ব্যবহারের চেয়ে কম সেটআপে নির্দিষ্ট পাবলিক গুগল এপিআই-এর সাথে সংযোগ স্থাপন করতে দেয়। আপনি এই এপিআইগুলো স্ক্রিপ্টের বিল্ট-ইন সার্ভিসের মতোই ব্যবহার করতে পারেন এবং এগুলো অটো-কমপ্লিশন ও অটোমেটিক অথরাইজেশনের মতো একই ধরনের সুবিধা প্রদান করে।
এই এপিআইগুলো কীভাবে ব্যবহার করতে হয়, তার কিছু উদাহরণের জন্য আমাদের কোড স্নিপেট পৃষ্ঠাটি দেখুন।
উপলব্ধ উন্নত এপিআই
- গুগল অ্যানালিটিক্স
- আপনি আপনার ওয়েবসাইটে আসা ট্র্যাফিক ট্র্যাক করতে এবং সেই অনুযায়ী আপনার ক্যাম্পেইনের বিড সামঞ্জস্য করতে গুগল অ্যানালিটিক্স ব্যবহার করতে পারেন। আপনি যদি আপনার গুগল অ্যাডস অ্যাকাউন্টের সাথে একটি গুগল অ্যানালিটিক্স প্রপার্টি লিঙ্ক করেন, তাহলে আপনি আপনার ওয়েবসাইটে গ্রাহকদের কার্যকলাপও বিশ্লেষণ করতে পারবেন। এই তথ্যটি আপনার ওয়েবসাইটের ট্র্যাফিক বা বিক্রয়ের কতটুকু গুগল অ্যাডস থেকে আসে সে সম্পর্কে ধারণা দিতে পারে এবং আপনার বিজ্ঞাপন ও ওয়েবসাইট উন্নত করতে সাহায্য করতে পারে। আপনি 'একটি ওয়েবসাইট এবং/অথবা অ্যাপের জন্য অ্যানালিটিক্স সেট আপ করুন' হেল্প সেন্টার গাইডের মাধ্যমে অ্যানালিটিক্স এবং গুগল অ্যাডস অ্যাকাউন্ট লিঙ্ক করার বিষয়ে আরও জানতে পারেন।
- গুগল বিগকোয়েরি
- আপনি গুগল ক্লাউড স্টোরেজে বিপুল পরিমাণ ডেটা লোড করতে পারেন এবং তারপর গুগল বিগকোয়েরি ব্যবহার করে সেই ডেটা কোয়েরি করতে পারেন। উদাহরণস্বরূপ, আপনি গত ১০ বছরের পাবলিক আবহাওয়ার ডেটা লোড করতে পারেন এবং তারপর এমন একটি স্ক্রিপ্টে কোনো অঞ্চলের গড় তাপমাত্রা কোয়েরি করতে পারেন, যা সেই তথ্য ব্যবহার করে বিড সমন্বয় করে। এর আরেকটি ব্যবহার হতে পারে বেশ কয়েক বছর ধরে আপনার অ্যাকাউন্টের পারফরম্যান্স ডেটার ওপর সংখ্যাতাত্ত্বিক বিশ্লেষণ করা।
- গুগল ক্যালেন্ডার
- আপনার স্ক্রিপ্ট ভবিষ্যতের কাজের জন্য ইভেন্ট তৈরি করতে পারে (উদাহরণস্বরূপ, আজ থেকে ২ সপ্তাহ পরে আপনার ক্যাম্পেইনগুলোর পারফরম্যান্স রিপোর্ট চালানো), অথবা আপনার ক্যালেন্ডারে তৈরি করা কোনো এন্ট্রির উপর ভিত্তি করে অ্যাকশন সম্পাদন করতে পারে (উদাহরণস্বরূপ, একটি নির্দিষ্ট তারিখে কোনো ক্যাম্পেইন চালু করা)।
- গুগল স্লাইডস
- আপনার স্ক্রিপ্ট ক্যাম্পেইনের বিবরণ বা পরিসংখ্যান গুগল স্লাইডসে এক্সপোর্ট করতে পারে, যাতে এই ধরনের তথ্য একটি উপস্থাপনযোগ্য বিন্যাসে প্রকাশ করা যায়।
- গুগল টাস্ক
- আপনার স্ক্রিপ্ট ভবিষ্যতের কাজের জন্য একটি রিমাইন্ডার তালিকা তৈরি করতে পারে (উদাহরণস্বরূপ, আজ থেকে দুই সপ্তাহ পরে আপনার ক্যাম্পেইনগুলোর পারফরম্যান্স রিপোর্ট চালানো), অথবা আপনার রিমাইন্ডার তালিকায় তৈরি করা কোনো এন্ট্রির উপর ভিত্তি করে বিভিন্ন কাজ সম্পাদন করতে পারে (উদাহরণস্বরূপ, একটি নির্দিষ্ট তারিখে কোনো ক্যাম্পেইন চালু করা)।
- মার্চেন্ট এপিআই
- আপনার স্ক্রিপ্ট মার্চেন্ট এপিআই ব্যবহার করে আপনার প্রোডাক্ট লিস্টিং আপলোড ও পরিচালনা করতে এবং আপনার গুগল মার্চেন্ট সেন্টার অ্যাকাউন্টগুলো পরিচালনা করতে পারে। স্ক্রিপ্টে, এটি প্রোডাক্ট লিস্টিং পরীক্ষা করতে এবং নির্দিষ্ট প্রোডাক্টকে নির্দিষ্ট বিজ্ঞাপনের সাথে লিঙ্ক করতে সহায়ক হতে পারে। মার্চেন্ট এপিআই-এর সাব-এপিআই রয়েছে যা অ্যাডভান্সড এপিআই ডায়ালগে আলাদাভাবে সক্রিয় করা যেতে পারে। আপনি 'রেজিস্টার অ্যাজ এ ডেভেলপার' গাইডের মাধ্যমে আপনার গুগল মার্চেন্ট সেন্টার অ্যাকাউন্ট লিঙ্ক করার বিষয়ে আরও জানতে পারেন।
- কেনাকাটার বিষয়বস্তু
- আপনার স্ক্রিপ্ট, আপনার পণ্যের তালিকা আপলোড ও পরিচালনা করতে এবং আপনার গুগল মার্চেন্ট সেন্টার অ্যাকাউন্টগুলো পরিচালনা করতে, শপিং-এর জন্য গুগল কন্টেন্ট এপিআই (Google Content API for Shopping) ব্যবহার করতে পারে। স্ক্রিপ্টে, পণ্যের তালিকা পরীক্ষা করতে এবং নির্দিষ্ট পণ্যকে নির্দিষ্ট বিজ্ঞাপনের সাথে লিঙ্ক করতে এটি কার্যকর হতে পারে। দ্রষ্টব্য: শপিং-এর জন্য কন্টেন্ট এপিআই-এর পরিষেবা ১৮ই আগস্ট, ২০২৬-এ বন্ধ হয়ে যাবে। এর পরিবর্তে মার্চেন্ট এপিআই (Merchant API) ব্যবহার করুন, যা পূর্ববর্তী বিভাগে বর্ণনা করা হয়েছে।
- ইউটিউব এবং ইউটিউব অ্যানালিটিক্স
- বিডিংয়ের সিদ্ধান্ত নেওয়ার জন্য আপনি আপনার ভিডিও, প্লেলিস্ট ইত্যাদি এবং সেইসাথে আপনার ভিডিওর পারফরম্যান্স ডেটাও পুনরুদ্ধার ও আপডেট করতে পারেন।
উন্নত এপিআই সক্রিয় করুন
কোন কোন গুগল এপিআই উন্নত এপিআই হিসেবে উপলব্ধ আছে তা দেখতে, উপরের এডিটর বারে থাকা অ্যাডভান্সড এপিআই বোতামে ক্লিক করুন।

এতে অ্যাডভান্সড এপিআই ডায়ালগ বক্সটি আসবে। আপনি যে এপিআইগুলো সক্রিয় করতে চান, সেগুলো চেক করুন।

এরপর, কনসোলে আপনার স্ক্রিপ্টের সাথে যুক্ত প্রজেক্টসহ এপিআই কনসোল পেজটি আনতে গুগল এপিআই কনসোল লিঙ্কে ক্লিক করুন; অথবা, যদি আপনার প্রজেক্টটি আগে থেকে নির্বাচিত না থাকে, তবে প্রজেক্ট ড্রপ-ডাউন তালিকা থেকে এটি নির্বাচন করুন। সার্চ বারে এপিআই-এর নাম লিখে আপনার স্ক্রিপ্টে ব্যবহার করতে চান এমন এপিআইগুলো অনুসন্ধান করুন।

অনুসন্ধানের ফলাফল থেকে API-টি নির্বাচন করুন এবং পরবর্তী পৃষ্ঠায় 'Enable' বেছে নিন; যদি আপনি একটি 'Disable' বাটন দেখতে পান, তাহলে এই API-টি ইতিমধ্যেই সক্রিয় করা আছে। আপনি যে প্রতিটি API সক্রিয় করতে চান, তার জন্য এই কাজটি পুনরাবৃত্তি করুন।

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

এখন আপনার এডিটরে ফিরে যেতে অ্যাডভান্সড এপিআই ডায়ালগটি বন্ধ করুন। নতুন এপিআইগুলো আপনার স্ক্রিপ্টের জন্য সক্রিয় হয়ে যাবে এবং অটোকমপ্লিট তালিকায় উপলব্ধ হবে।

চূড়ান্ত বিবেচনা
অ্যাডভান্সড এপিআইগুলো নিয়ে কাজ করার সময় কয়েকটি বিষয় মনে রাখতে হবে।
প্রকল্প আইডি
প্রতিটি গুগল অ্যাডস স্ক্রিপ্টের সাথে একটি গুগল ক্লাউড প্রজেক্ট আইডি (যা প্রজেক্ট নম্বর নামেও পরিচিত) যুক্ত থাকে। আপনি অ্যাডভান্সড এপিআই ডায়ালগ থেকে গুগল এপিআই কনসোল পৃষ্ঠাটি খুলে আপনার স্ক্রিপ্টের প্রজেক্ট নম্বরটি খুঁজে পেতে পারেন। এই প্রজেক্ট আইডিটি স্ক্রিপ্ট তৈরি করার সময় তৈরি হয় এবং এটি সেই ব্যবহারকারীর সাথে সংযুক্ত থাকে যিনি গুগল অ্যাডস স্ক্রিপ্টটি তৈরি করেছেন। যদি স্ক্রিপ্টটি তৈরি করা ব্যবহারকারীকে পরে অ্যাকাউন্ট থেকে সরিয়ে দেওয়া হয়, তাহলে যে ব্যবহারকারী স্ক্রিপ্টটি অ্যাক্সেস করার চেষ্টা করবেন তাকে স্ক্রিপ্টটি পুনরায় অনুমোদন করতে এবং অ্যাডভান্সড এপিআই নির্ভরতাগুলো আবার সেটআপ করতে বলা হবে। একটি নতুন গুগল ডেভেলপার প্রজেক্ট আইডি-ও তৈরি হবে এবং আপনাকে অ্যাডভান্সড এপিআইগুলো আবার সেটআপ করতে হবে, যেমনটি এই ডকুমেন্টের শুরুতে ব্যাখ্যা করা হয়েছে।
নির্ভরশীলতা
অ্যাকাউন্টে স্ক্রিপ্টটি তৈরি করা ব্যবহারকারীই কেবল সেই স্ক্রিপ্টের অ্যাডভান্সড এপিআই নির্ভরতা পরিবর্তন করতে পারবেন।
অনুমতি
এপিআই (API) অ্যাক্সেস করার সময়, একটি স্ক্রিপ্ট সেই ব্যবহারকারীর অনুমতি ব্যবহার করে যিনি স্ক্রিপ্টটিকে অনুমোদন দিয়েছেন। নিশ্চিত করুন যে, স্ক্রিপ্টটিকে অনুমোদনকারী ব্যবহারকারীর ব্যবহৃত সমস্ত অ্যাডভান্সড এপিআই (Advanced API) এবং স্ক্রিপ্টটির প্রয়োজনীয় ডেটাতে অ্যাক্সেস আছে। আপনি যদি গুগল অ্যানালিটিক্স এপিআই (Google Analytics API) ব্যবহার করেন, তবে যাচাই করে নিন যে স্ক্রিপ্টটিকে অনুমোদনকারী ব্যবহারকারীর অ্যাক্সেস করা অ্যানালিটিক্স অ্যাকাউন্টের জন্য প্রয়োজনীয় অনুমতি আছে।
শর্তাবলী
প্রতিটি অ্যাডভান্সড এপিআই-এর নিজস্ব শর্তাবলী থাকতে পারে, যা গুগল এপিআই কনসোলে এপিআই সক্রিয় করার সময় আপনাকে মেনে নিতে হবে।
কোটা
বেশিরভাগ অ্যাডভান্সড এপিআই-এর সাথে একটি বিনামূল্যের দৈনিক কোটা যুক্ত থাকে। আপনার স্ক্রিপ্ট এই কোটা অতিক্রম করলে, এপিআইটি কাজ করা বন্ধ করে দেবে, যতক্ষণ না আপনি অতিরিক্ত ডেটার জন্য অনুরোধ করেন অথবা বিনামূল্যের কোটা পুনরায় পূরণ করা হয়। আপনি অ্যাডভান্সড এপিআই ডায়ালগ থেকে স্ক্রিপ্টটির জন্য গুগল এপিআই কনসোল খুলে আপনার স্ক্রিপ্ট দ্বারা ব্যবহৃত কোটা নিরীক্ষণ করতে পারেন। গুগল এপিআই কনসোল আপনাকে এপিআই-এর জন্য অতিরিক্ত কোটার অনুরোধ করার একটি উপায়ও প্রদান করে।
বিলিং
কিছু অ্যাডভান্সড এপিআই ব্যবহারের জন্য আপনাকে অর্থ প্রদান করতে হবে। এই অর্থপ্রদান আপনার স্ক্রিপ্টের সাথে যুক্ত গুগল ক্লাউড প্রজেক্টের মাধ্যমে পরিচালিত হয়, গুগল অ্যাডসের মাধ্যমে নয়। আপনার স্ক্রিপ্টের গুগল ক্লাউড প্রজেক্টের জন্য বিলিং কীভাবে চালু করবেন সে সম্পর্কে আরও বিস্তারিত জানতে আমাদের ডকুমেন্টেশন দেখুন।