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 অ্যাক্সেস:

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

    • আপনার সিস্টেমে Python 3.10 বা তার পরবর্তী ভার্সন ইনস্টল করা থাকতে হবে এবং PATH-এ থাকতে হবে। জেনারেট করা কোড এক্সিকিউট করতে এবং লোকাল ভ্যালিডেশন সাইডকার রান করতে Python ব্যবহার করা হয়।
    • হোস্ট এজেন্ট প্ল্যাটফর্ম:
    • আপনার সিস্টেম 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) যোগ করতে পারেন।

Antigravity

Linux / macOS:

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

Windows (PowerShell):

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

Claude Code

Linux / macOS:

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

Windows (PowerShell):

.\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 কোয়েরি তৈরি, যাচাই ও রান করে, টার্মিনালে লাইভ ফর্ম্যাট করা টেবিল স্ট্রিম করে।

    • "গ্রাহক 123-456-7890-এর জন্য গত মাসে খরচের ভিত্তিতে সেরা ৫টি কীওয়ার্ড দেখাও।"
    • "ফলাফল 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-এর মতো স্কিল টুলের নাম ব্যবহার করে এইসব একই ক্ষমতা প্রয়োগ করুন, যেমন মূল ফিচার-এ বর্ণনা করা হয়েছে:

স্ল্যাশ কমান্ড উদ্দেশ্য উদাহরণ
/validate-gaql GAQL সিনট্যাক্স, কম্প্যাটিবিলিটি ও নিয়ম যাচাই করে। /validate-gaql
/inspect-object Protobuf ফিল্ড, ধরন ও এনাম পরীক্ষা করে। /inspect-object Campaign
/get-cids ম্যানেজার অ্যাকাউন্টের ক্রম ও ক্লায়েন্ট CID সংক্রান্ত সমস্যার সমাধান করে। /get-cids 1234567890
/troubleshoot-conversions অফলাইন কনভার্সন আপলোড ডায়াগনস্টিকস রান করে। /troubleshoot-conversions
/pmax-filter PMax লিস্টিং ফিল্টার ও বাদ দেওয়ার তালিকা তৈরি করে। /pmax-filter
/explain ৪-অংশের স্ট্রাকচার্ড ব্যাখ্যা প্রদান করে। /explain shared set
/step-by-step একাধিক ধাপের টাস্ক এক্সিকিউশন প্ল্যান তৈরি করে। /step-by-step upload conversions
/assistant-tutorial ১১-ধাপের একটি ইন্টার‍্যাক্টিভ ওয়াকথ্রু রান করে। /assistant-tutorial

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

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

Antigravity

Linux / macOS:

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

Windows (PowerShell):

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

Claude Code

Linux / macOS:

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

Windows (PowerShell):

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

আনইনস্টলেশন

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

Antigravity

Linux / macOS:

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

Windows (PowerShell):

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

তারপর আপনার Antigravity হোস্ট সেশন রিস্টার্ট করুন।

Claude Code

অ্যাক্টিভ Claude Code সেশনে:

/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 রিপোজিটরিতে CONTRIBUTING.md ফাইলটি দেখুন।

পরবর্তী ধাপ

পূর্ববর্তী
Google Ads API ডেভেলপার অ্যাসিস্ট্যান্ট কী?