গুগল বিজ্ঞাপন এপিআই ডেভেলপার সহকারী

Google Ads API ডেভেলপার অ্যাসিস্ট্যান্ট হল Gemini CLI-এর জন্য একটি শক্তিশালী এক্সটেনশন যা আপনার Google Ads API কর্মপ্রবাহকে ত্বরান্বিত করার জন্য ডিজাইন করা হয়েছে। অ্যাসিস্ট্যান্ট আপনাকে স্বাভাবিক ভাষা ব্যবহার করে Google Ads API-এর সাথে ইন্টারঅ্যাক্ট করতে দেয়, যার ফলে আপনার টার্মিনালে সরাসরি প্রশ্ন জিজ্ঞাসা করা, কোড তৈরি করা, ডেটা পুনরুদ্ধার করা এবং সমস্যা সমাধান করা সহজ হয়।

সুবিধা

  • উৎপাদনশীলতা বৃদ্ধি করুন: ডকুমেন্টেশন অনুসন্ধান এবং বয়লারপ্লেট কোড লেখার জন্য কম সময় ব্যয় করুন।
  • জটিল কাজগুলি সহজ করুন: সহজ ইংরেজি প্রম্পট থেকে Google বিজ্ঞাপন কোয়েরি ল্যাঙ্গুয়েজ (GAQL) এবং ক্লায়েন্ট লাইব্রেরি কোড তৈরি করুন।
  • API শিখুন: API ধারণাগুলি বুঝুন এবং দেখুন কিভাবে প্রাকৃতিক ভাষার অনুরোধগুলি এক্সিকিউটেবল কোডে অনুবাদ হয়।
  • ইন্টারেক্টিভ ডিবাগিং: ত্রুটিগুলি বুঝতে সাহায্য পান এবং সমস্যা সমাধানের জন্য ধাপে ধাপে নির্দেশিকা পান।
  • স্ট্রিমলাইনড ওয়ার্কফ্লো: আপনার ডেভেলপমেন্ট এবং টেস্টিং লুপ কমান্ড লাইনের মধ্যে রাখুন।

পূর্বশর্ত

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

  1. Google বিজ্ঞাপন API অ্যাক্সেস:

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

    • পাইথন ৩.১০ বা তার পরবর্তী সংস্করণ। পাইথন হল ডিফল্ট ভাষা, তাই আপনার এটি ইনস্টল করা এবং আপনার পথে থাকা আবশ্যক।
    • জেমিনি সিএলআই ইনস্টল করা হয়েছে।
    • jq (কমান্ড-লাইন JSON প্রসেসর)। যদি অনুপস্থিত থাকে তবে সেটআপ স্ক্রিপ্ট এটি ইনস্টল করার চেষ্টা করবে।

  3. সংগ্রহস্থল:

    • GitHub থেকে google-ads-api-developer-assistant সংগ্রহস্থলের একটি স্থানীয় ক্লোন:

শুরু করুন

  1. প্রকল্প ডিরেক্টরিতে নেভিগেট করুন:

    cd <full path>/google-ads-api-developer-assistant

  2. সেটআপ স্ক্রিপ্টটি চালান: এই স্ক্রিপ্টটি সহকারীর GEMINI.md কনটেক্সট ফাইল এবং প্রয়োজনীয় সরঞ্জামগুলি ব্যবহার করার জন্য জেমিনি CLI কনফিগার করে।

    ./setup.sh

    যদি আপনি উইন্ডোজ ব্যবহার করেন, তাহলে setup.ps1 PowerShell স্ক্রিপ্টটি চালান।

  3. জেমিনি সিএলআই শুরু করুন:

    gemini

  4. সহকারীর সাথে যোগাযোগ করুন: আপনি এখন স্বাভাবিক ভাষায় প্রশ্ন জিজ্ঞাসা করতে পারেন বা আদেশ দিতে পারেন।

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

  • স্বাভাবিক ভাষা প্রশ্নোত্তর: Google Ads API বৈশিষ্ট্য, সেরা অনুশীলন, অথবা নির্দিষ্ট সংস্থান সম্পর্কে প্রশ্ন জিজ্ঞাসা করুন।

    • "উপলব্ধ প্রচারণার ধরণগুলি কী কী?"
    • "GAQL-এ তারিখ অনুসারে আমি কীভাবে ফিল্টার করব?"
    • "ক্লিক_ভিউ এবং ইমপ্রেশন_ভিউয়ের মধ্যে পার্থক্য ব্যাখ্যা করুন।"

  • কোড জেনারেশন: GAQL কোয়েরি এবং এক্সিকিউটেবল পাইথন কোড স্নিপেট তৈরি করুন।

    • "গত ৩০ দিনে সবচেয়ে বেশি রূপান্তরিত প্রচারণাগুলি আমাকে দেখান।"
    • "১২৩৪৫ ক্যাম্পেইন আইডির জন্য সমস্ত সক্রিয় বিজ্ঞাপন গ্রুপের নাম পান।"
    • "সকল প্রচারণা জুড়ে অননুমোদিত বিজ্ঞাপন খুঁজুন।" তৈরি করা কোডটি saved_code/ ডিরেক্টরিতে সংরক্ষিত হয়।

  • সরাসরি API কার্যকরকরণ: জেমিনি CLI থেকে সরাসরি জেনারেট করা পঠনযোগ্য পাইথন স্ক্রিপ্টগুলি চালান এবং আপনার টার্মিনালে ফর্ম্যাট করা ফলাফল দেখুন। সহকারী কোড তৈরি করার পরে, আপনি একটি অন-স্ক্রিন প্রম্পট পাবেন: 

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

run লিখুন, এবং স্ক্রিপ্টটি Assistant প্রসঙ্গে কার্যকর হবে।

  • CSV রপ্তানি: API কল থেকে সারণী ফলাফল একটি CSV ফাইলে সংরক্ষণ করুন।

    • "ফলাফলগুলি একটি CSV ফাইলে সংরক্ষণ করুন।" ফাইলগুলি saved_csv/ ডিরেক্টরিতে সংরক্ষিত হয়।

  • সমস্যা সমাধানে সহায়তা: ত্রুটি বার্তা বা অপ্রত্যাশিত API আচরণের ক্ষেত্রে সহায়তা পান।

    • "আমি 'AuthenticationError.OAUTH_TOKEN_INVALID' ত্রুটিটি পেয়েছি, আমার কী করা উচিত?"
    • "আমার প্রশ্নের কোন ফলাফল কেন দেখতে পাচ্ছি না?"

ব্যবহারের উদাহরণ

  • রিপোর্টিং:
    • "১২৩৪৫৬৭৮ গ্রাহকের জন্য গত মাসের খরচ অনুসারে আমাকে সেরা ৫টি কীওয়ার্ড দিন।"
  • অ্যাকাউন্ট কাঠামো:
    • "সকল প্রচারণার নাম এবং তাদের পরিচয়পত্র তালিকাভুক্ত করুন।"
  • সমস্যা সমাধান:
    • "আমি ১০০টি রূপান্তর আপলোড করেছি, কিন্তু UI তে মাত্র ৭৮টি দেখা যাচ্ছে। API ব্যবহার করে আমি কীভাবে এটি ডিবাগ করতে পারি?"
  • শেখা:
    • "API ব্যবহার করে কীভাবে একটি পারফরম্যান্স ম্যাক্স ক্যাম্পেইন তৈরি করতে হয় তা আমাকে বলুন।"

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

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

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