উন্নত API

Google Ads স্ক্রিপ্টের উন্নত API ডেভেলপারদের নির্দিষ্ট কিছু পাবলিক Google API-এর সাথে কানেক্ট করতে দেয়। এতে তাদের HTTP ইন্টারফেস ব্যবহার করার চেয়ে কম সেটআপ লাগে। আপনি এই API-গুলি স্ক্রিপ্টের বিল্ট-ইন পরিষেবার মতোই ব্যবহার করতে পারেন এবং এগুলি অটো-কমপ্লিশন ও অটোমেটিক অথরাইজেশনের মতো একই সুবিধা প্রদান করে।

এইসব API কীভাবে ব্যবহার করতে হয় তার কিছু উদাহরণ দেখতে আমাদের কোড স্নিপেট পৃষ্ঠা দেখুন।

উপলভ্য উন্নত API

Google Analytics
মনে রাখবেন: উন্নত API ডায়ালগে Analytics উন্নত API বন্ধ হয়ে যাওয়া Universal Analytics v3 API-কে টার্গেট করে এবং এটিতে করা অনুরোধ ব্যর্থ হয়। Google Ads স্ক্রিপ্ট Google Analytics 4 AnalyticsData বা AnalyticsAdmin উন্নত পরিষেবা সাপোর্ট করে না। স্ক্রিপ্ট থেকে Google Analytics 4 ডেটা কোয়েরি করতে, UrlFetchApp পরিষেবা এবং OAuth 2.0 ব্যবহার করে Google Analytics Data API-তে HTTPS অনুরোধ পাঠান। এছাড়াও, আপনি Google Ads অ্যাকাউন্টের সাথে Google Analytics 4 প্রপার্টি লিঙ্ক করতে পারেন যাতে ওয়েবসাইট ও অ্যাপ কনভার্সন ডেটা সরাসরি শেয়ার করা যায়। সেট-আপ সংক্রান্ত নির্দেশাবলীর জন্য, Analytics সেট-আপ সংক্রান্ত গাইড দেখুন।
Google BigQuery
আপনি Google Cloud Storage-এ প্রচুর পরিমাণে ডেটা লোড করতে পারেন এবং তারপরে Google BigQuery ব্যবহার করে সেই ডেটা কোয়েরি করতে পারেন। যেমন, আপনি গত ১০ বছরের আবহাওয়ার পাবলিক ডেটা লোড করতে পারেন এবং তারপরে কোনও অঞ্চলের গড় তাপমাত্রা সম্পর্কে কোয়েরি করতে পারেন। এই তথ্য স্ক্রিপ্টে ব্যবহার করে বিড অ্যাডজাস্ট করা যায়। আরেকটি ব্যবহার হল, কয়েক বছর ধরে আপনার অ্যাকাউন্টের পারফর্ম্যান্স ডেটার উপর নম্বর ক্রাঞ্চিং করা।
Google Calendar
আপনার স্ক্রিপ্ট ভবিষ্যতের টাস্কের জন্য ইভেন্ট তৈরি করতে পারে (যেমন, আজ থেকে ২ সপ্তাহ পরে আপনার ক্যাম্পেনের জন্য পারফর্ম্যান্স রিপোর্ট রান করা) অথবা আপনার ক্যালেন্ডারে তৈরি করা এন্ট্রির ভিত্তিতে অ্যাকশন পারফর্ম করতে পারে (যেমন, নির্দিষ্ট তারিখে ক্যাম্পেন চালু করা)।
Google Slides
আপনার স্ক্রিপ্ট Google Slides-এ ক্যাম্পেনের বিবরণ বা পরিসংখ্যান এক্সপোর্ট করতে পারে যাতে এই ধরনের তথ্য প্রেজেন্টেশন ফর্ম্যাটে প্রকাশ করা যায়।
Google Tasks
আপনার স্ক্রিপ্ট ভবিষ্যতের টাস্কের জন্য রিমাইন্ডার তালিকা তৈরি করতে পারে (যেমন, আজ থেকে দুই সপ্তাহ পরে আপনার ক্যাম্পেনের জন্য পারফর্ম্যান্স রিপোর্ট রান করা) অথবা আপনার তৈরি করা রিমাইন্ডার তালিকার এন্ট্রির ভিত্তিতে অ্যাকশন নিতে পারে (যেমন, নির্দিষ্ট তারিখে ক্যাম্পেন চালু করা)।
Merchant API
আপনার স্ক্রিপ্ট, মার্চেন্ট API ব্যবহার করে আপনার প্রোডাক্ট তালিকা আপলোড ও ম্যানেজ করতে এবং আপনার Google Merchant Center অ্যাকাউন্ট ম্যানেজ করতে পারে। স্ক্রিপ্টে, এটি প্রোডাক্ট তালিকা চেক করতে এবং নির্দিষ্ট প্রোডাক্টকে নির্দিষ্ট বিজ্ঞাপনের সাথে লিঙ্ক করতে সহায়ক হতে পারে। Merchant API-এর সাব-API আছে যা উন্নত API ডায়ালগে আলাদাভাবে চালু করা যেতে পারে। আপনি ডেভেলপার হিসেবে রেজিস্টার করুন নির্দেশিকা থেকে আপনার Google Merchant Center অ্যাকাউন্ট লিঙ্ক করার ব্যাপারে আরও জানতে পারবেন।
শপিং কন্টেন্ট
আপনার স্ক্রিপ্ট, Google Content API for Shopping ব্যবহার করে আপনার প্রোডাক্ট তালিকা আপলোড ও ম্যানেজ করতে এবং আপনার Google Merchant Center অ্যাকাউন্ট ম্যানেজ করতে পারে। স্ক্রিপ্টে, এটি প্রোডাক্ট তালিকা চেক করতে এবং নির্দিষ্ট প্রোডাক্টকে নির্দিষ্ট বিজ্ঞাপনের সাথে লিঙ্ক করতে উপযোগী হতে পারে। মনে রাখবেন: Content API for Shopping, ১৮ আগস্ট, ২০২৬-এ বন্ধ করে দেওয়া হবে। এর পরিবর্তে, Merchant API ব্যবহার করুন, যা আগের বিভাগে বর্ণনা করা হয়েছে।
YouTube এবং YouTube Analytics
আপনি নিজের ভিডিও, প্লেলিস্ট ইত্যাদি এবং বিডিং সংক্রান্ত সিদ্ধান্ত নেওয়ার জন্য ভিডিওর পারফর্ম্যান্স ডেটা ফিরিয়ে আনতে ও আপডেট করতে পারবেন।

উন্নত API চালু করুন

কোন কোন Google API উন্নত API হিসেবে উপলভ্য তা দেখতে, উপরের এডিটর বারে উন্নত API বিকল্পে ক্লিক করে উন্নত API ডায়ালগ বক্স দেখুন। আপনি যে API চালু করতে চান সেটি বেছে নিন।

আপনার বেছে নেওয়া বিকল্প সেভ করতে এবং স্ক্রিপ্ট এডিটরে ফিরে যেতে সেভ করুন বিকল্পে ক্লিক করুন। আপনার স্ক্রিপ্টের জন্য নতুন API চালু করা হবে এবং অটোমেটিক সম্পূর্ণ করার তালিকায় উপলভ্য হবে।

বিবেচনা করার মতো আরও বিষয়

উন্নত API নিয়ে কাজ করার সময় কিছু বিষয় মনে রাখতে হবে।

ডিপেন্ডেন্সি

অ্যাকাউন্টে যে ব্যবহারকারী স্ক্রিপ্ট তৈরি করেছেন, শুধুমাত্র তিনিই সেই স্ক্রিপ্টের জন্য উন্নত API নির্ভরতা পরিবর্তন করতে পারবেন।

অনুমতি

উন্নত API অ্যাক্সেস করার সময়, স্ক্রিপ্ট সেই ব্যবহারকারীর অনুমতি ব্যবহার করে যিনি স্ক্রিপ্টটি অনুমোদন করেছেন। অনুমোদনকারী ব্যবহারকারীর কাছে স্ক্রিপ্টের জন্য প্রয়োজনীয় সমস্ত ডেটার অ্যাক্সেস থাকতে হবে। যেমন, BigQuery উন্নত API ব্যবহার করতে, অনুমোদনকারী ব্যবহারকারীর কাছে টার্গেট Google Cloud প্রোজেক্ট এবং BigQuery ডেটাসেটের জন্য প্রয়োজনীয় অনুমতি থাকতে হবে।

মে ২০১৯-এর আগের স্ক্রিপ্টের জন্য বিবেচ্য বিষয়

মে ২০১৯-এর আগে তৈরি করা স্ক্রিপ্টের জন্য, স্ক্রিপ্টের সাথে যুক্ত Google Cloud প্রোজেক্টে আপনাকে প্রাসঙ্গিক API ম্যানুয়ালি চালু করতে হতে পারে। আপনার স্ক্রিপ্ট প্রভাবিত হয়েছে কিনা তা জানতে, উন্নত API ডায়ালগে Google Cloud Console-এর লিঙ্ক আছে কিনা দেখুন।

উন্নত API চালু করুন

২০১৯ সালের আগের স্ক্রিপ্টের জন্য, আপনার স্ক্রিপ্টে ব্যবহার করতে চান এমন প্রতিটি উন্নত API আপনাকে ম্যানুয়ালি চালু করতে হবে:

  1. উন্নত API বোতামে ক্লিক করুন। নিম্নলিখিত ডায়ালগ উইন্ডোতে, Google Cloud Console-এর লিঙ্কে ক্লিক করুন।
  2. আপনার প্রোজেক্ট আগে থেকে বেছে নেওয়া না থাকলে, প্রোজেক্ট ড্রপ-ডাউন তালিকা থেকে সেটি বেছে নিন।
  3. সার্চ বারে API-এর নাম লিখে আপনার স্ক্রিপ্টে যে API ব্যবহার করতে চান সেটি সার্চ করুন।
  4. সার্চ ফলাফল থেকে API বেছে নিন এবং পরবর্তী পৃষ্ঠায় "চালু করুন" বোতামে ক্লিক করুন।

যে ব্যবহারকারী স্ক্রিপ্ট তৈরি করেছেন তাকে পরে অ্যাকাউন্ট থেকে সরিয়ে দেওয়া হলে, স্ক্রিপ্ট অ্যাক্সেস করার চেষ্টা করা যেকোনও নতুন ব্যবহারকারীকে উন্নত API ডিপেন্ডেন্সি আবার চালু করার পাশাপাশি স্ক্রিপ্ট আবার অনুমোদিত করার জন্য প্রম্পট করা হবে।