Google Ads API Developer Assistant v3.0.0 রিলিজ করা হয়েছে

বুধবার, ১০ জুন, ২০২৬

আমরা আনন্দের সাথে জানাচ্ছি যে Google Ads API Developer Assistant-এর v3.0.0 রিলিজ করা হয়েছে। এই প্রধান রিলিজটি Assistant-এর বিবর্তনে একটি উল্লেখযোগ্য মাইলফলক চিহ্নিত করে, যা আর্কিটেকচারাল আধুনিকীকরণ, উন্নত নির্ভরযোগ্যতা এবং আরও মডুলার ডিজাইনের উপর ফোকাস করে।

এই রিলিজের মাধ্যমে, আমরা Assistant-কে Google Antigravity এজেন্ট ফ্রেমওয়ার্কে মাইগ্রেট করছি এবং দক্ষতা-ভিত্তিক আর্কিটেকচারে ট্রানজিশন করছি। এইসব পরিবর্তন Assistant-কে আরও শক্তিশালী করে তোলে, এটি ম্যানেজ করা সহজ করে এবং টোকেনের ব্যবহার কমায়।

v3.0.0-এ নতুন কী আছে?

১. Antigravity ফ্রেমওয়ার্ক দ্বারা পরিচালিত

Google Ads API ডেভেলপার অ্যাসিস্ট্যান্ট gemini-cli থেকে Antigravity এজেন্ট ফ্রেমওয়ার্কে (v3.0.0) মাইগ্রেট করা হয়েছে। এই অন্তর্নিহিত ফ্রেমওয়ার্ক আপগ্রেড আরও স্ট্রাকচার্ড ও নির্ভরযোগ্য এক্সিকিউশন এনভায়রনমেন্ট প্রদান করে। এর পাশাপাশি, প্রোজেক্টের ডিরেক্টরি ও ফাইল স্ট্রাকচার আপডেট করা হয়েছে যাতে তা সম্পূর্ণভাবে Antigravity-রেডি হয়।

gemini-cli-এর জন্য সহায়তা ১৮ জুন, ২০২৬-এ বন্ধ হয়ে যাবে, যেমনটি এই Google ব্লগ ঘোষণায় বিস্তারিতভাবে জানানো হয়েছে।

২. মডিউলার, দক্ষতা-ভিত্তিক আর্কিটেকচার

আমরা Assistant-এর মূল ক্ষমতাকে দক্ষতায় রূপান্তরিত করেছি। কন্টেক্সট ফাইলে বিস্তারিত, অসংগঠিত নির্দেশাবলীর উপর নির্ভর করার পরিবর্তে, Assistant এখন প্রয়োজন হলে ডাইনামিকভাবে বিশেষ, টেস্ট-ব্যাকড টুল ডিরেক্টরি (দক্ষতা) লোড করে। এটি "হ্যালুসিনেশন" উল্লেখযোগ্যভাবে কমায় এবং নিশ্চিত করে যে টাস্কগুলি সঠিক, যাচাই করা পদ্ধতি ব্যবহার করে সম্পন্ন করা হয়েছে।

এই মডিউলার ট্রানজিশনে গুরুত্বপূর্ণ আপডেটের মধ্যে রয়েছে:

  • GAQL যাচাইকরণ (validate_gaql): একটি নির্দিষ্ট দক্ষতায় সরানো হয়েছে। এতে এখন তারিখের সেগমেন্ট, click_viewটি এক দিনের ফিল্টার এবং change_statusটি সীমানার জন্য উন্নত স্ট্যাটিক কোয়েরি চেক অন্তর্ভুক্ত রয়েছে।
  • কনভার্সন সংক্রান্ত সমস্যার সমাধান করা (troubleshoot_conversions): পুরনো conversions_support_package-এর পরিবর্তে এটি ব্যবহার করা হয়। এটি সব কনভার্সন সংক্রান্ত সমস্যার সমাধানকরণ ও আপলোড করা সামারি স্ক্রিপ্ট একত্রিত করে এবং একটি সিঙ্গল, সুসংহত স্কিল ডিরেক্টরিতে টেস্ট করে।
  • স্ট্রাকচার্ড কমান্ড (explain এবং step_by_step): ব্যাখ্যার জন্য সামঞ্জস্যপূর্ণ, স্ট্রাকচার্ড লেআউট এনফোর্স করার জন্য স্কিলে কনভার্ট করা হয়েছে।
  • নতুন অ্যাকাউন্ট ম্যাপিং (get_cids_under_mcc): ম্যানেজার অ্যাকাউন্টের (MCC) অধীনে থাকা সব চাইল্ড অ্যাকাউন্ট ফিরিয়ে আনার নতুন স্কিল।
  • নতুন অবজেক্ট ইন্সপেকশন (inspect_object): Protobuf মেসেজ ও Enum ডাইনামিক উপায়ে চটপট দেখার জন্য নতুন দক্ষতা, যাতে Assistant সবসময় সঠিক স্ট্রাকচার ব্যবহার করে তা নিশ্চিত করা যায়।
  • নতুন PMax লিস্টিং ফিল্টার (pmax_listing_filter): পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের জন্য লিস্টিং গ্রুপ ওয়েবপেজ এক্সক্লুশন ট্রি মডিফিকেশন স্ট্যান্ডার্ডাইজ করার নতুন স্কিল।

৩. উন্নত কনসিস্টেন্সি ও কঠোরতা

খুব ভালো কোয়ালিটির কোড জেনারেশন ও কোয়েরি যাচাইকরণ নিশ্চিত করতে আমরা আরও কঠোর নিয়ম ও প্রয়োজনীয়তা চালু করেছি:

  • স্পষ্ট API ভার্সনিং: get_cids_under_mcc, validate_gaql ও troubleshoot_conversions-এর মতো গুরুত্বপূর্ণ দক্ষতার জন্য এখন স্পষ্ট api_version আর্গুমেন্ট প্রয়োজন, যা অস্পষ্টতা দূর করে।
  • কঠোর GAQL নিয়ম:
    • GAQL কোয়েরিতে SQL অ্যাগ্রিগেট ফাংশন (যেমন SUM, COUNT এবং AVG) ব্যবহার করা আটকানোর জন্য AGENTS.md-এ একটি নিয়ম যোগ করা হয়েছে, কারণ সেগুলি কাজ করে না।
    • Assistant যাতে আপ-টু-ডেট ডকুমেন্টেশন ব্যবহার করে তা নিশ্চিত করতে, বর্তমান API ভার্সনের জন্য প্রথমে Google Ads API ডেভেলপার সাইটের রিলিজ নোট চেক করার জন্য একটি নিয়ম যোগ করা হয়েছে।
    • স্ট্রিমলাইন করা কনফিগারেশন: AGENTS.md স্ট্রিমলাইন করা হয়েছে যার ফলে প্রাথমিক কন্টেক্সট উইন্ডো ছোট হয়েছে। প্রোগ্রাম্যাটিক দক্ষতার জন্য ডুপ্লিকেট কনভার্সন ডকুমেন্টেশন সরিয়ে দেওয়া হয়েছে।

৪. Developer Experience (DX) সংক্রান্ত উন্নতি

আপনার ডেভেলপমেন্ট লুপ আরও দ্রুত ও মসৃণ করতে আমরা কোয়ালিটি-অফ-লাইফে বেশ কিছু উন্নতি করেছি:

  • পারসিস্টেন্ট ভার্চুয়াল এনভায়রনমেন্ট (.venv): সেশন শেষ হয়ে গেলে ভার্চুয়াল এনভায়রনমেন্ট আর মুছে যায় না। স্টার্টআপের সময়, Assistant আপনার সিস্টেমের Python ভার্সন চেক করে; Python-এর নতুন ভার্সন উপলভ্য থাকলে তবেই এটি .venv আবার তৈরি করে।
  • স্মার্ট API ভার্সন ক্যাশিং: Assistant এখন ১৯ ঘণ্টার TTL সহ বর্তমান Google Ads API ভার্সন ক্যাশ করে, যা অপ্রয়োজনীয় নেটওয়ার্ক চেক এড়িয়ে স্টার্টআপের সময় কমায়।
  • পারসিস্টেন্ট লগের মাধ্যমে আরও ভাল ডিবাগিং: লগ মেসেজে এখন তারিখ ও সময়ের স্ট্যাম্প অন্তর্ভুক্ত থাকে। লগ ফাইল .agents/ ডিরেক্টরিতে লেখা হয় এবং প্রতিবার রান করার সময় আর রিসেট হয় না, সমস্যার সমাধান করার জন্য ইতিহাস সংরক্ষণ করে।

আপনি কেন আপগ্রেড করবেন?

v3.0.0-এ আপগ্রেড করার মূল উদ্দেশ্য হল নির্ভরযোগ্যতা ও স্ট্রাকচার। Antigravity ফ্রেমওয়ার্কে চলে যাওয়া এবং স্কিল অনুযায়ী ফিচার মডিউলারাইজ করার মাধ্যমে, আমরা Assistant-কে আরও বেশি অনুমানযোগ্য এবং রিসোর্স-দক্ষ করে তুলেছি।

আপনি যদি আরও দ্রুত স্টার্টআপ, আরও নির্ভরযোগ্য GAQL যাচাইকরণ এবং আরও শক্তিশালী সমস্যা সমাধানের অভিজ্ঞতা চান, তাহলে আমরা v3.0.0-এ আপগ্রেড করার সাজেশন দিই।

শুরু করুন

প্রথম ইনস্টলেশন

  1. Antigravity CLI ইনস্টল করুন: https://antigravity.google/ লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন।
  2. Assistant ক্লোন করা: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. ইনস্টল স্ক্রিপ্ট রান করুন:
    • Linux/macOS: ./install.sh রান করুন (ডিফল্ট হিসেবে Python-এ কাজ করে, অন্যান্য ভাষার জন্য --php বা --ruby-এর মতো ফ্ল্যাগ ব্যবহার করুন)।
    • Windows: PowerShell খুলে .\install.ps1 রান করুন।

v2.x থেকে আপগ্রেড করুন

  1. saved/ থেকে প্রোজেক্ট ডিরেক্টরির বাইরে কোনও নিরাপদ লোকেশনে যেকোনও কাস্টম কোড বা ডেটা কপি করুন।
  2. Assistant-এর লোকাল ক্লোন মুছে দিন।
  3. রিপোজিটরি ক্লোন করুন:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. নতুন Antigravity এনভায়রনমেন্ট শুরু করতে ইনস্টল স্ক্রিপ্ট (install.sh বা install.ps1) রান করুন।

বব হ্যানকক, Google Ads API টিম

লেবেল: google-ads-api, release