গুগল অ্যাডস এপিআই ডেভেলপার অ্যাসিস্ট্যান্ট আপনার এআই কোডিং পরিবেশে সরাসরি গুগল অ্যাডস এপিআই ডোমেইনের গভীর দক্ষতা নিয়ে আসে। কোয়েরি তৈরি করতে, ক্লায়েন্ট লাইব্রেরি কোড জেনারেট করতে, রিড-অনলি এপিআই কল এক্সিকিউট করতে, অ্যাড-হক রিপোর্ট স্ট্রিম করতে এবং ইন্টিগ্রেশন ট্রাবলশুট করতে ন্যাচারাল ল্যাঙ্গুয়েজ প্রম্পট ও বিল্ট-ইন স্ল্যাশ কমান্ড ব্যবহার করুন।

অ্যাসিস্ট্যান্টটি গুগল অ্যান্টিগ্র্যাভিটি এবং ক্লড কোড এজেন্ট ফ্রেমওয়ার্কের (v4.0.0) জন্য একটি মডিউলার প্লাগইন হিসেবে তৈরি করা হয়েছে। এটি স্থায়ী কনটেক্সট, শক্তিশালী সুরক্ষা সীমানা এবং স্বয়ংক্রিয় ভ্যালিডেশন পাইপলাইন বজায় রাখার জন্য AGENTS.md ও CLAUDE.md কন্ট্রাক্ট, বিল্ট-ইন স্ল্যাশ কমান্ড এবং বিশেষায়িত ডোমেইন স্কিল ব্যবহার করে।

পূর্বশর্ত

শুরু করার আগে, নিশ্চিত হয়ে নিন আপনার কাছে নিম্নলিখিত জিনিসগুলো আছে:

1. গুগল অ্যাডস এপিআই অ্যাক্সেস:

   • গুগল অ্যাডস এপিআই ডেভেলপার টোকেন ।
   • আপনার হোম ডিরেক্টরিতে অবস্থিত একটি গুগল অ্যাডস কনফিগারেশন ফাইল, যা আপনার ডেভেলপার টোকেন, OAuth 2.0 ক্রেডেনশিয়াল এবং কাস্টমার আইডি দিয়ে কনফিগার করা থাকে (উদাহরণস্বরূপ, পাইথনের জন্য google-ads.yaml )। ক্লায়েন্ট লাইব্রেরি কনফিগারেশন গাইডটি দেখুন।
   • গুগল অ্যাডস এপিআই-এর ধারণা এবং প্রমাণীকরণ সম্পর্কে পরিচিতি।

2. সফটওয়্যার:

   • পাইথন ৩.১০ বা তার নতুন সংস্করণ ইনস্টল করা এবং আপনার সিস্টেম PATH-এ অন্তর্ভুক্ত থাকতে হবে। জেনারেট করা কোড এক্সিকিউট করতে এবং লোকাল ভ্যালিডেশন সাইডকারগুলো চালাতে পাইথন ব্যবহৃত হয়।
   • হোস্ট এজেন্ট প্ল্যাটফর্ম:
     • গুগল অ্যান্টিগ্র্যাভিটি কমান্ড-লাইন টুল ( agy ), অথবা
     • ক্লড কোড কমান্ড-লাইন টুল (নোড.জেএস ১৮+ এর সাথে claude )।
   • আপনার সিস্টেম PATH-এ Git ইনস্টল করা আছে।

শুরু করুন

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

১. রিপোজিটরি ক্লোন করুন

রিপোজিটরিটি আপনার লোকাল মেশিনে ক্লোন করুন এবং প্রজেক্ট ডিরেক্টরিতে যান:

git clone https://github.com/googleads/google-ads-api-developer-assistant
cd google-ads-api-developer-assistant

২. ইনস্টলেশন স্ক্রিপ্টটি চালান

আপনার টার্গেট প্ল্যাটফর্মের জন্য ইনস্টলেশন স্ক্রিপ্টটি চালান। ডিফল্টরূপে, পাইথন ক্লায়েন্ট লাইব্রেরি অন্তর্ভুক্ত থাকে। আপনি ঐচ্ছিকভাবে অতিরিক্ত ক্লায়েন্ট লাইব্রেরি অন্তর্ভুক্ত করতে পারেন ( --php , --ruby , --java , --dotnet , অথবা --all )।

৩. পরিচয়পত্র কনফিগার করুন

নিশ্চিত করুন যে আপনার API কনফিগারেশন ফাইল (যেমন, google-ads.yaml , google_ads_php.ini , বা google_ads_config.rb ) আপনার $HOME ডিরেক্টরিতে রাখা আছে।

(ঐচ্ছিক) একটি ডিফল্ট কাস্টমার আইডি কনফিগার করতে, আপনার কাস্টমার আইডি নম্বরটি সরাসরি config/customer_id.txt ফাইলে প্রবেশ করান (উদাহরণস্বরূপ, 1234567890 )। এছাড়াও আপনি config/api_version.txt ফাইলে আপনার সক্রিয় API ভার্সনটি পরীক্ষা বা পিন করতে পারেন।

৪. প্লাগইনটি সক্রিয় করুন।

• অ্যান্টিগ্র্যাভিটি: প্লাগইনটি লোড করতে আপনার অ্যান্টিগ্র্যাভিটি / agy হোস্ট সেশনটি পুনরায় চালু করুন।
• Claude Code: একটি সক্রিয় Claude Code সেশনে, /reload-plugins চালান অথবা claude পুনরায় চালু করুন।

৫. সহকারীর সাথে যোগাযোগ করুন

আপনি সরাসরি আপনার টার্মিনালে স্বাভাবিক ভাষার প্রম্পট বা নির্দিষ্ট স্ল্যাশ কমান্ড ব্যবহার করে অ্যাসিস্ট্যান্টের সাথে যোগাযোগ করতে পারেন।

মূল বৈশিষ্ট্য

• স্বাভাবিক ভাষায় প্রশ্নোত্তর এবং ধারণাগত নির্দেশনা: গুগল অ্যাডস এপিআই-এর ফিচার, আর্কিটেকচারাল নিয়মাবলী বা নির্দিষ্ট রিসোর্স সম্পর্কে প্রশ্ন করুন। অ্যাসিস্ট্যান্টটি শুধুমাত্র সাধারণ এলএলএম প্রশিক্ষণের উপর নির্ভর না করে, অফিশিয়াল এপিআই সংজ্ঞার উপর ভিত্তি করে উত্তর দেয়।

  • কী কী ধরনের ক্যাম্পেইন পাওয়া যায়?
  • GAQL-এ তারিখ অনুযায়ী কীভাবে ফিল্টার করব?
  • click_view এবং impression_view এর মধ্যে পার্থক্য ব্যাখ্যা করুন।
  • শেয়ার্ড সেট কী এবং আমি এটি কীভাবে ব্যবহার করব?
  • ক্লড কোডের স্ল্যাশ কমান্ডসমূহ: /explain , /step-by-step , /assistant-tutorial

• নির্ভরযোগ্য ক্লায়েন্ট লাইব্রেরি কোড তৈরি: অফিসিয়াল গুগল অ্যাডস ক্লায়েন্ট লাইব্রেরি (পাইথন, জাভা, পিএইচপি, ডট নেট এবং রুবি) ব্যবহার করে পরীক্ষিত ও প্রচলিত রীতিসম্মত কোড তৈরি করুন।

  • গত ৩০ দিনে সর্বাধিক কনভার্সন হওয়া ক্যাম্পেইনগুলো দেখান।
  • গ্রাহক 123-456-7890-এর জন্য সক্রিয় সমস্ত বিজ্ঞাপন গ্রুপের নাম খুঁজুন।
  • একটি পারফরম্যান্স ম্যাক্স ক্যাম্পেইন তৈরি করার জন্য কোড লিখুন। তৈরি হওয়া কোডটি saved/code/ ডিরেক্টরিতে সংরক্ষিত হয়।

• প্রোগ্রাম্যাটিক GAQL কোয়েরি ভ্যালিডেশন: জটিল কোয়েরিগুলো কার্যকর করার আগে স্বয়ংক্রিয়ভাবে এপিআই মেটাডেটা, ফিল্ডের সামঞ্জস্যতা, জিরো-ইম্প্রেশন নিয়ম এবং তারিখ বিভাজনের ভিত্তিতে পরীক্ষা ও যাচাই করুন।

  • ক্লড কোড: /validate-gaql
  • স্বাভাবিক ভাষা: validate: SELECT campaign.id FROM campaign

• অবজেক্ট এবং প্রোটোবাফ স্কিমা পরিদর্শন: রিমোট মেটাডেটার অতিরিক্ত বোঝা ছাড়াই যেকোনো সক্রিয় API সংস্করণের জন্য রিসোর্স কাঠামো, নেস্টেড ফিল্ড, ডেটা টাইপ এবং এনাম ভ্যালু গতিশীলভাবে পরিদর্শন করুন।

  • ক্লড কোড: /inspect-object <resource_or_enum>
  • স্বাভাবিক ভাষা: "ক্যাম্পেইন রিসোর্স পরিদর্শন করুন"

• অ্যাড হক লাইভ রিপোর্টিং এবং CSV এক্সপোর্ট: সহজ ইংরেজিতে পারফরম্যান্স ডেটা চেয়ে নিন। অ্যাসিস্ট্যান্ট সরাসরি আপনার অ্যাকাউন্টের বিপরীতে GAQL কোয়েরি তৈরি, যাচাই এবং রান করে, এবং টার্মিনালে লাইভ ফরম্যাট করা টেবিল স্ট্রিম করে।

  • গ্রাহক 123-456-7890-এর জন্য গত মাসে খরচ অনুযায়ী শীর্ষ ৫টি কীওয়ার্ড দেখান।
  • ফলাফলগুলো একটি CSV ফাইল হিসেবে সংরক্ষণ করুন। (exports to saved/csv/ যাবে)।

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

  • অ্যাসিস্ট্যান্টকে শুধু বলুন: "কোডটি চালান" অথবা "স্ক্রিপ্টটি চালান" ।
  • পরিবর্তন সুরক্ষা: নিরাপত্তার জন্য, পরিবর্তনমূলক অপারেশনগুলো (তৈরি, আপডেট, ডিলিট) saved/code/ ফোল্ডারে তৈরি করা হয়, কিন্তু অ্যাসিস্ট্যান্ট দ্বারা সরাসরি কখনো এক্সিকিউট করা হয় না। এগুলো অ্যাসিস্ট্যান্টের বাইরে ম্যানুয়ালি পর্যালোচনা ও এক্সিকিউট করুন।

• উন্নত ডায়াগনস্টিকস এবং কনভার্সন ট্রাবলশুটিং: অফলাইন কনভার্সন আপলোড ব্যর্থতার কারণ অনুসন্ধান করুন, আপলোড ফাইল প্রি-ভ্যালিডেট করুন এবং বিস্তারিত ডায়াগনস্টিক রিপোর্ট তৈরি করুন।

  • ক্লড কোড: /troubleshoot-conversions
  • স্বাভাবিক ভাষা: "গ্রাহক 123-456-7890-এর জন্য রূপান্তর সংক্রান্ত সমস্যা সমাধান করুন।" (রিপোর্টগুলি saved/data/ ফোল্ডারে সংরক্ষিত হয়েছে)।

• এমসিসি অ্যাকাউন্ট হায়ারার্কি ম্যাপিং: একটি ম্যানেজার অ্যাকাউন্টের অধীনে সাব-অ্যাকাউন্টের গ্রাহক আইডিগুলো পুনরুদ্ধার করুন এবং অ্যাকাউন্ট হায়ারার্কিগুলো ম্যাপ করুন।

  • ক্লড কোড: /get-cids <manager_cid>
  • স্বাভাবিক ভাষা: "ম্যানেজার 123-456-7890-এর অধীনে থাকা সমস্ত ক্লায়েন্ট গ্রাহক আইডি সংগ্রহ করুন"

• পারফরম্যান্স ম্যাক্স লিস্টিং ফিল্টার এবং বর্জন: অ্যাসেট গ্রুপগুলির জন্য প্রোডাক্ট পার্টিশন ট্রি এবং ওয়েবপেজ ইউআরএল বর্জন তৈরি করুন।

  • ক্লড কোড: /pmax-filter
  • স্বাভাবিক ভাষা: "আমার PMax ক্যাম্পেইনের জন্য ওয়েবপেজ বর্জন ফিল্টার তৈরি করুন"

• অতিরিক্ত কোডবেস প্রসঙ্গ: আপনার অ্যাপ্লিকেশন লজিক এবং কাস্টম আর্কিটেকচারকে অ্যাসিস্ট্যান্টের যুক্তিপদ্ধতির মধ্যে নিবন্ধন করুন।

  • লিনাক্স / ম্যাকওএস: bash ./update.sh agy --context_dir /path/to/your/codebase # Or for Claude Code: ./update.sh claude --context_dir /path/to/your/codebase
  • উইন্ডোজ (পাওয়ারশেল): powershell .\update.ps1 -Type agy -ContextDir C:\path\to\your\codebase

ক্লড কোড স্ল্যাশ কমান্ড রেফারেন্স

Claude Code ব্যবহার করার সময়, নিম্নলিখিত বিল্ট-ইন স্ল্যাশ কমান্ডগুলো উপলব্ধ থাকে। Google Antigravity-তে, 'মূল বৈশিষ্ট্য' (Key features ) অংশে বর্ণিত পদ্ধতি অনুযায়ী, স্বাভাবিক ভাষার প্রম্পট অথবা validate_gaql এবং inspect_object মতো স্কিল টুলের নাম ব্যবহার করে এই একই ক্ষমতাগুলো প্রয়োগ করা যায়।

রক্ষণাবেক্ষণ এবং আপডেট

রিপোজিটরি, প্লাগইন ইনস্টলেশন এবং ক্লায়েন্ট লাইব্রেরি আপডেট করতে:

আনইনস্টলেশন

অ্যাসিস্ট্যান্ট প্লাগইনটি আনইনস্টল করতে:

সম্প্রদায় এবং সমর্থন

• গিটহাব ইস্যু: রিপোজিটরির Issues ট্যাবে বাগ রিপোর্ট করুন, ফিচারের পরামর্শ দিন বা সাহায্যের জন্য জিজ্ঞাসা করুন।
• ডিসকর্ড: গুগল অ্যাডভার্টাইজিং অ্যান্ড মেজারমেন্ট কমিউনিটি ডিসকর্ড সার্ভারের #ads-api-ai-tools চ্যানেলে আলোচনায় যোগ দিন।
• মতামত: এই সমীক্ষা ফর্মের মাধ্যমে আপনার মতামত জানান।

অবদান নির্দেশিকা

অবদান স্বাগত! নির্দেশিকার জন্য গিটহাব রিপোজিটরিতে থাকা CONTRIBUTING.md ফাইলটি দেখুন।