Google Ads API ডেভেলপার অ্যাসিস্ট্যান্ট ইনস্টল ও ব্যবহার করা

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

Assistant-কে Google Antigravity এবং Claude Code এজেন্ট ফ্রেমওয়ার্কের (v4.0.0) জন্য মডিউলার প্লাগ-ইন হিসেবে তৈরি করা হয়েছে। এটি AGENTS.md এবং CLAUDE.md কন্ট্র্যাক্ট, বিল্ট-ইন স্ল্যাশ কমান্ড এবং বিশেষ ডোমেন দক্ষতা ব্যবহার করে অবিরাম প্রসঙ্গ, শক্তিশালী নিরাপত্তা সীমানা এবং অটোমেটেড যাচাইকরণ পাইপলাইন বজায় রাখে। এর আর্কিটেকচার ও ডিজাইনের ওভারভিউয়ের জন্য Google Ads API Developer Assistant কী? দেখুন।

পূর্বশর্ত

শুরু করার আগে, আপনার কাছে নিম্নলিখিতগুলি আছে কিনা তা ভালোভাবে দেখে নিন:

1. Google Ads API অ্যাক্সেস:

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

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

   • আপনার সিস্টেমে Python 3.10 বা তার পরবর্তী ভার্সন ইনস্টল করা আছে এবং PATH-এ আছে। জেনারেট করা কোড এক্সিকিউট করতে এবং লোকাল ভ্যালিডেশন সাইডকার রান করতে Python ব্যবহার করা হয়।
   • হোস্ট এজেন্ট প্ল্যাটফর্ম:
     • Google Antigravity কমান্ড-লাইন টুল (agy), অথবা
     • Claude Code কমান্ড-লাইন টুল (claude সহ Node.js 18+)।
   • আপনার সিস্টেম PATH-এ Git ইনস্টল করা আছে।

শুরু করুন

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

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

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

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

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

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

./install.sh agy
# Or include additional client libraries:
./install.sh agy --java --dotnet

.\install.ps1 -Type agy
# Or include additional client libraries:
.\install.ps1 -Type agy -Java -Dotnet

./install.sh claude
# Or include additional client libraries:
./install.sh claude --php --dotnet

.\install.ps1 -Type claude
# Or include additional client libraries:
.\install.ps1 -Type claude -Php -Dotnet

৩. ক্রেডেনশিয়াল কনফিগার করুন

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

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

৪. প্লাগ-ইন অ্যাক্টিভেট করুন

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

৫. Assistant-এর সাথে ইন্টার‍্যাক্ট করা

আপনি স্বাভাবিক ভাষা প্রম্পট বা আপনার টার্মিনালে সরাসরি নির্দিষ্ট স্ল্যাশ কমান্ড ব্যবহার করে Assistant-এর সাথে ইন্টার‍্যাক্ট করতে পারেন।

মূল ফিচার

• ন্যাচারাল ল্যাঙ্গুয়েজে প্রশ্নোত্তর ও ধারণাগত নির্দেশিকা: Google Ads API ফিচার, আর্কিটেকচারাল নিয়ম, পেশাদার পদ্ধতি বা নির্দিষ্ট রিসোর্স সম্পর্কে প্রশ্ন করুন। Assistant শুধুমাত্র সাধারণ LLM ট্রেনিংয়ের উপর নির্ভর না করে অফিসিয়াল API সংজ্ঞার উপর ভিত্তি করে উত্তর দেয়।

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

• গ্রাউন্ডেড ক্লায়েন্ট লাইব্রেরি কোড জেনারেশন: অফিসিয়াল Google Ads ক্লায়েন্ট লাইব্রেরি (Python, Java, PHP, .NET এবং Ruby) ব্যবহার করে টেস্ট করা, ইডিওমেটিক কোড জেনারেট করুন।

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

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

  • Claude Code: /validate-gaql
  • ন্যাচারাল ল্যাঙ্গুয়েজ: validate: SELECT campaign.id FROM campaign

• অবজেক্ট ও Protobuf স্কিমা ইন্সপেকশন: রিমোট মেটাডেটা ওভারহেড ছাড়াই যেকোনও অ্যাক্টিভ API ভার্সনের জন্য রিসোর্স স্ট্রাকচার, নেস্টেড ফিল্ড, ডেটার ধরন ও enum ভ্যালু ডায়নামিকভাবে ইন্সপেক্ট করুন।

  • Claude Code: /inspect-object <resource_or_enum>
  • ন্যাচারাল ল্যাঙ্গুয়েজ: "ক্যাম্পেন রিসোর্স পরীক্ষা করুন"

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

  • "১২৩-৪৫৬-৭৮৯০ গ্রাহকের জন্য গত মাসে খরচের ভিত্তিতে সেরা ৫টি কীওয়ার্ড দেখাও।"
  • "ফলাফল CSV ফাইল হিসেবে সেভ করুন।" (saved/csv/-এ এক্সপোর্ট করা হয়)।

• সরাসরি API এক্সিকিউশন ও মিউটেট নিরাপত্তা: ম্যানেজ করা ভার্চুয়াল এনভায়রনমেন্টের মধ্যে সরাসরি জেনারেট করা শুধু-পড়ার-উপযোগী স্ক্রিপ্ট এক্সিকিউট করুন।

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

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

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

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

  • Claude Code: /get-cids <manager_cid>
  • ন্যাচারাল ল্যাঙ্গুয়েজ: "ম্যানেজার 123-456-7890-এর অধীনে থাকা সব ক্লায়েন্ট কাস্টমার আইডি দেখাও"

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

  • Claude Code: /pmax-filter
  • ন্যাচারাল ল্যাঙ্গুয়েজ: "আমার PMax ক্যাম্পেনের জন্য ওয়েবপেজ বাদ দেওয়ার ফিল্টার তৈরি করো"

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

  • Linux / macOS:

    ./update.sh agy --context_dir /path/to/your/codebase
    # Or for Claude Code:
    ./update.sh claude --context_dir /path/to/your/codebase
    

  • Windows (PowerShell):

    .\update.ps1 -Type agy -ContextDir C:\path\to\your\codebase
    

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

Claude Code ব্যবহার করার সময়, নিম্নলিখিত বিল্ট-ইন স্ল্যাশ কমান্ড উপলভ্য থাকে। Google Antigravity-তে, ন্যাচারাল ল্যাঙ্গুয়েজ প্রম্পট বা validate_gaql এবং inspect_object-এর মতো স্কিল টুলের নাম ব্যবহার করে এইসব একই ক্ষমতাকে আহ্বান করুন, যেমন মূল ফিচার-এ বর্ণনা করা হয়েছে:

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

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

./update.sh agy          # Update Antigravity plugin
./update.sh agy --all    # Include all client libraries

.\update.ps1 -Type agy
.\update.ps1 -Type agy -All

./update.sh claude       # Update Claude Code plugin
./update.sh claude --all # Include all client libraries

.\update.ps1 -Type claude
.\update.ps1 -Type claude -All

আনইনস্টলেশন

Assistant প্লাগ-ইন আনইনস্টল করতে:

rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Remove-Item -Recurse -Force `
  "$HOME\.gemini\config\plugins\google-ads-api-developer-assistant"

/plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

claude plugin uninstall \
  google-ads-api-developer-assistant@google-ads-assistant-local

claude plugin marketplace remove google-ads-assistant-local

কমিউনিটি ও সহায়তা

• GitHub সংক্রান্ত সমস্যা: রিপোজিটরির সমস্যা ট্যাবে গিয়ে বাগ সম্পর্কে অভিযোগ জানান, ফিচার সাজেস্ট করুন অথবা সাহায্যের জন্য অনুরোধ করুন।
• Discord: Google Advertising and Measurement Community Discord সার্ভার-এ #ads-api-ai-tools চ্যানেলে আলোচনায় যোগ দিন।
• মতামত: এই সমীক্ষা ফর্ম-এর মাধ্যমে আপনার মতামত শেয়ার করুন।

কন্ট্রিবিউশন সংক্রান্ত নির্দেশিকা

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

পরবর্তী ধাপ

• Google Ads API এজেন্ট স্কিল ইনস্টল করুন
• Google Ads MCP সার্ভারে আপনার AI ক্লায়েন্ট কানেক্ট করুন
• Google Ads API Developer Assistant কীভাবে কাজ করে তা জানুন