دستیار توسعه‌دهنده API گوگل ادز را نصب و استفاده کنید

پیش‌نیازها

قبل از شروع، مطمئن شوید که موارد زیر را دارید:

  1. دسترسی به API تبلیغات گوگل:

  2. نرم‌افزار:

    • پایتون ۳.۱۰ یا جدیدتر. پایتون زبان پیش‌فرض است، بنابراین باید آن را نصب کرده و در مسیر خود داشته باشید.
    • ابزار خط فرمان گوگل Antigravity نصب شده است.
    • jq (پردازنده JSON خط فرمان). در صورت عدم وجود، اسکریپت نصب سعی در نصب آن خواهد کرد.

  3. مخزن:

شروع کنید

  1. به دایرکتوری پروژه بروید:

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

    (نکته: اگر ادغام پوسته Antigravity را فعال کرده باشید، ورود به این دایرکتوری به طور خودکار جلسه دستیار را راه‌اندازی می‌کند.)

  2. اسکریپت نصب را اجرا کنید: این اسکریپت محیط توسعه را راه‌اندازی اولیه می‌کند و کتابخانه‌های مورد نیاز کلاینت گوگل ادز را کلون می‌کند (پایتون به طور پیش‌فرض نصب شده است).

    ./install.sh

    اگر از ویندوز استفاده می‌کنید، اسکریپت پاورشل install.ps1 را اجرا کنید.

  3. پیکربندی اعتبارنامه‌ها: مطمئن شوید که google-ads.yaml (یا معادل زبانی آن) در دایرکتوری خانگی شما قرار دارد.

  4. تعامل با دستیار: پس از فعال شدن جلسه، می‌توانید با استفاده از زبان طبیعی مستقیماً در ترمینال خود با دستیار تعامل داشته باشید.

ویژگی‌های کلیدی

  • پرسش و پاسخ به زبان طبیعی: در مورد ویژگی‌های API گوگل ادز، بهترین شیوه‌ها یا منابع خاص سوال بپرسید.

    • «انواع کمپین‌های موجود کدامند؟»
    • "چگونه می‌توانم در GAQL بر اساس تاریخ فیلتر کنم؟"
    • «تفاوت بین click_view و impression_view را توضیح دهید.»

  • تولید کد: کوئری‌های GAQL و قطعه کدهای پایتون قابل اجرا تولید کنید.

    • «کمپین‌هایی را که بیشترین تبدیل را در ۳۰ روز گذشته داشته‌اند، به من نشان بده.»
    • «نام همه گروه‌های تبلیغاتی فعال‌شده برای شناسه کمپین ۱۲۳۴۵ را دریافت کنید.»
    • «تبلیغات رد شده را در تمام کمپین‌ها پیدا کنید.» کد تولید شده به طور خودکار با استفاده ruff linted شده و در دایرکتوری saved/code/ ذخیره می‌شود.

  • اجرای مستقیم API: اسکریپت‌های پایتون فقط خواندنی تولید شده را مستقیماً در یک محیط مجازی مجزا ( .venv ) اجرا کنید و نتایج قالب‌بندی شده را به صورت جداول در ترمینال خود مشاهده کنید.

    • به سادگی به دستیار بگویید: «کد را اجرا کن» یا «اسکریپت را اجرا کن» .
    • برای ایمنی، عملیات جهش (ایجاد، به‌روزرسانی، حذف) تولید می‌شوند اما هرگز اجرا نمی‌شوند.

  • خروجی CSV: نتایج جدولی حاصل از فراخوانی‌های API را در یک فایل CSV ذخیره کنید.

    • «نتایج را در یک فایل CSV ذخیره کنید.» فایل‌ها در دایرکتوری saved/csv/ ذخیره می‌شوند.

  • تشخیص و عیب‌یابی پیشرفته: در مورد پیام‌های خطا، رفتار غیرمنتظره API یا مشکلات تبدیل آفلاین، کمک بگیرید.

    • «چرا هیچ نتیجه‌ای برای درخواستم نمی‌بینم؟»
    • «عیب‌یابی تبدیل‌های من برای مشتری ‎123-456-7890.» (یک گزارش تشخیصی دقیق در saved/data/ ایجاد می‌کند).

  • زمینه اضافی: کدبیس یا کتابخانه‌های سفارشی خود را برای زمینه اضافه کنید.

    • از اسکریپت update.sh به همراه گزینه --context_path برای ثبت فایل‌های پروژه خود استفاده کنید: none ./update.sh --context_path /path/to/your/codebase
    • این به دستیار اجازه می‌دهد تا منطق برنامه شما را در استدلال خود هنگام ایجاد پاسخ‌ها یا تولید کد به زبان دلخواه شما لحاظ کند.

موارد استفاده مثال

  • گزارش‌دهی:
    • «۵ کلمه کلیدی برتر بر اساس هزینه برای ماه گذشته برای مشتری ۱۲۳۴۵۶۷۸ را به من بدهید.»
  • ساختار حساب:
    • «نام تمام کمپین‌ها و شناسه‌های آنها را فهرست کنید.»
  • عیب‌یابی:
    • «من ۱۰۰ تبدیل آپلود کردم، اما فقط ۷۸ تای آنها در رابط کاربری نمایش داده می‌شوند. چطور می‌توانم با استفاده از API این مشکل را برطرف کنم؟»
  • یادگیری:
    • «/توضیح دهید که یک مجموعه مشترک چیست»
  • تولید کد:
    • «کدی بنویسید که یک کمپین Performance Max برای company name ایجاد کند.»

جامعه و پشتیبانی

دستورالعمل‌های مشارکت

از مشارکت‌ها استقبال می‌شود! برای راهنمایی بیشتر به فایل CONTRIBUTING.md در مخزن گیت‌هاب مراجعه کنید.

قبلی
دستیار توسعه‌دهنده API گوگل ادز چیست؟