جاوااسکریپت Google Ads پلاتفرم خودکارسازی بدون سروری ارائه می‌دهد که به شما امکان می‌دهد بااستفاده از جاوااسکریپت مدرن (ES6+) در IDE مبتنی بر مرورگر، داده‌های Google Ads خود را به‌صورت برنامه‌نویسی‌شده مدیریت و پُرسمان کنید. با جاوااسکریپت Google Ads، می‌توانید گردش‌های کاری مدیریت حساب معمول را خودکار کنید، گزارش‌های سفارشی ایجاد کنید، و Google Ads را با منابع داده خارجی ادغام کنید—در یک حساب یا هزاران حساب—بدون نیاز به تأمین سرورها یا مدیریت اطلاعات کاربری توسعه‌دهنده.
اکثر ویژگی‌های Google Ads ازطریق فراخوانی‌های mutate و search در جاوااسکریپت Google Ads دردسترس هستند. می‌توانید از دستورگان‌ها برای موارد زیر استفاده کنید:
- مدیریت پویش‌ها، گروه‌های آگهی، کلیدواژه‌ها، و آگهی‌ها.
- پیشنهادهای قیمت، بودجه‌ها، و وضعیت را براساس عملکرد هم‌زمان یا داده‌های خارجی تنظیم کنید.
- بااستفاده از زبان پُرسمان Google Ads (GAQL) پُرسمان‌ها را اجرا کنید تا گزارش‌ها و داشبوردهای سفارشی تولید کنید.
- اجراهای خودکارسازی‌شده را زمان‌بندی کنید تا به‌صورت ساعتی، روزانه، هفتگی، ماهانه، یا درصورت نیاز اجرا شوند.
- بااستفاده از دستورگان‌های مدیر، عملیات چندحسابی را در حساب‌های فرزند هماهنگ کنید.
- به سرویس‌های Google Workspace (مثل «کاربرگ‌نگار» و Drive)، سرویس‌های Google Cloud (مثل BigQuery)، و میاناهای برنامه‌سازی کاربردی طرف سوم متصل شوید.
«دستورگان» همچنین شامل گزینشگرهای نهاد و گزارش‌های داخلی است.
مشخصات فنی کلیدی
مشخصات فنی زیر محیط اجرا و مرزهای عملیاتی دستورگان Google Ads را تعریف می‌کند:
| مشخصات | دستورگان حساب تکی | دستورگان حساب مدیر |
|---|---|---|
| مهلت اجرا | حداکثر ۳۰ دقیقه |
حداکثر ۶۰ دقیقه با executeInParallel و تماس برگشتی
(۳۰ دقیقه استاندارد)
|
| موتور زمان اجرا | زمان اجرای جاوا اسکریپت V8 (ECMAScript 6+) | زمان اجرای جاوا اسکریپت V8 (ECMAScript 6+) |
| محدودیت تکرارگر نهاد | به‌طور پیش‌فرض، ۵۰٬۰۰۰ نهاد در هر تکرارکننده (گزارش‌ها و پُرسمان‌های جستجو مستثنا هستند) | ۵۰٬۰۰۰ نهاد برای هر حساب فرزند (گزارش‌ها و پرسمان‌های جستجو مستثنی هستند) |
| حساب‌های موازی | موجود نیست (۱ حساب) | تا ۵۰ حساب به‌طور موازی |
| محدودیت بارگذاری انبوه | اندازه فایل ۵۰ مگابایت، ۱٬۰۰۰٬۰۰۰ ردیف | اندازه فایل ۵۰ مگابایت، ۱٬۰۰۰٬۰۰۰ ردیف |
| دستورگان‌های مجاز | تا ۲۵۰ دستورگان مجاز برای هر کاربر | حداکثر ۲۵۰ دستورگان مجاز برای هر کاربر |
| میزبانی و زیرساخت | کاملاً تحت مدیریت Google (بدون سرور) | کاملاً تحت‌مدیریت Google (بدون سرور) |
برای اطلاعات بیشتر، به محدودیت‌ها مراجعه کنید.
آیا دستورگانه‌های Google Ads محصول مناسبی برای من است؟
Google محصولات متعددی را برای کمک به خودکارسازی حساب‌های Google Ads ارائه می‌دهد. جدول زیر سناریوها و توصیه‌های رایج را برای کمک به شما در انتخاب محصول مناسب برای نیازهایتان نشان می‌دهد:
| سناریو | توصیه | ویژگی‌های کلیدی |
|---|---|---|
| من توسعه‌دهنده‌ای هستم که می‌خواهم محصول نرم‌افزاری خودم را بسازم یا با Google Ads API ادغام کنم. در نوشتن کد و مدیریت زیرساخت نرم‌افزار شامل سرورها و پایگاه‌های داده راحت هستم. | از Google Ads API استفاده کنید. | کنترل کامل میانای برنامه‌سازی کاربردی، توان عملیاتی بالاتر، میزبانی اختصاصی، و مدیریت OAuth. |
| من توسعه‌دهنده‌ای هستم که با نوشتن کد مشکلی ندارم، اما ترجیح می‌دهم زیرساخت نرم‌افزاری خودم را مدیریت نکنم. | از اسکریپت‌های Google Ads استفاده کنید. | اجرای بدون سرور در Google Ads، زمان‌بندی خودکار، IDE مبتنی بر مرورگر. |
| من توسعه‌دهنده نیستم، اما مایل هستم برای یادگیری برنامه‌نویسی جهت خودکارسازی Google Ads کمی زمان صرف کنم. | از اسکریپت‌های Google Ads استفاده کنید. | نحو جاوا اسکریپت ساده، الگوهای اسکریپت ازپیش‌ساخته، تکمیل خودکار IDE، و برجسته‌سازی نحو. |
| می‌خواهم پویش‌های ویدیویی را به‌صورت برنامه‌ریزی‌شده مدیریت کنم. | از جاوااسکریپت Google Ads استفاده کنید. |
مدیریت مستقیم پویش ویدیویی بااستفاده از
AdsApp.videoCampaigns().
|
| می‌خواهم تکالیف را برای اجرا بدون نیاز به جلسه کاربر فعال زمان‌بندی کنم. | از اسکریپت‌های Google Ads استفاده کنید. | مجوزدهی پس‌زمینه OAuth2 با زمان‌بندی خودکار ساعتی، روزانه، هفتگی، یا ماهانه. |
| می‌خواهم به‌صورت برنامه‌نویسی‌شده به حساب‌های Google Ads تودرتوی خودم دسترسی داشته باشم. | از دستورگان‌های مدیر برای دسترسی به حساب‌های کودک ارائه از یک دستورگان استفاده کنید. |
تکرار متوالی در حساب‌های کودک، یا اجرای موازی در
حداکثر ۵۰ حساب کودک بااستفاده از executeInParallel.
|
| می‌خواهم «میاناهای برنامه‌سازی کاربردی» متعلق به Google یا شخص ثالث را در مدیریت Google Ads ادغام کنم. | استفاده از Google APIs یا میاناهای برنامه‌سازی کاربردی طرف سوم با جاوااسکریپت Google Ads. |
سرویس‌های داخلی Google Workspace («کاربرگ‌نگار»، Drive، Mail)، Google APIs پیشرفته (BigQuery، Analytics، YouTube)، و UrlFetchApp برای REST APIs خارجی.
|
| من تحلیل‌گر داده (یا نقش مشابه) هستم که می‌خواهم گزارش‌های Google Ads را برای تحلیل بیشتر بارگیری کنم. | از BigQuery Data Transfer Service برای Google Ads استفاده کنید. | خط لوله خودکارسازی‌شده زمان‌بندی‌شده برای داده‌های Google Ads در BigQuery بدون کد. |
| می‌خواهم Google Ads را به‌صورت انبوه مدیریت کنم و مشکلی با نوشتن کد ندارم. | از بارگذاری‌های انبوه با «جاوااسکریپت‌های Google Ads» استفاده کنید. | بارگذاری صفحه‌گسترده یا CSV برنامه‌ریزی‌شده که از حداکثر ۱٬۰۰۰٬۰۰۰ ردیف پشتیبانی می‌کند. |
| می‌خواهم Google Ads را به‌صورت انبوه مدیریت کنم، اما نمی‌خواهم هیچ کدی بنویسم. | از قوانین خودکارسازی‌شده، بارگذاری‌های انبوه، یا Google Ads Editor استفاده کنید. | ابزارهای واسط کاربر یا رایانه بدون کد برای به‌روزرسانی‌های انبوه و قوانین زمان‌بندی‌شده. |
پیش‌نیازها
فقط آشنایی در سطح مبتدی با JavaScript لازم است—IDE به برجسته‌سازی نحو، تکمیل خودکار، و پیش‌دید کمک می‌کند. تنها چیزی که نیاز دارید یک حساب Google Ads است تا نوشتن اولین اسکریپت خود را شروع کنید.
پرسشگان
پاسخ پرسش‌های رایج درباره معماری، محدودیت‌های اجرا، و ادغام‌های جاوااسکریپت Google Ads را پیدا کنید.
جاوااسکریپت Google Ads چیست؟
جاوااسکریپت Google Ads محیط خودکارسازی بدون سروری را در Google Ads ارائه می‌دهد. این‌ها به تبلیغ‌کنندگان و توسعه‌دهندگان امکان می‌دهند کد JavaScript بنویسند تا سنجه‌های عملکرد را پُرسمان کنند، پویش‌ها را ایجاد و اصلاح کنند، قیمت‌های پیشنهادی و بودجه‌ها را به‌روز کنند، و بدون پیکربندی سرورها، مدیریت نشان‌های OAuth، یا پرداخت هزینه زیرساخت، با میاناهای برنامه‌سازی کاربردی خارجی ارتباط برقرار کنند.
جاوااسکریپت Google Ads چه تفاوتی با Google Ads API دارد؟
جاوااسکریپت‌های Google Ads مستقیماً در حساب Google Ads شما بااستفاده از جاوااسکریپت اجرا می‌شوند، به هیچ زیرساخت سروری نیاز ندارند، و مجوز را به‌طور خودکار در مرورگر مدیریت می‌کنند. Google Ads API یک REST و gRPC API است که برای برنامه‌های سازمانی در مقیاس بزرگ‌تر، ابزارهای شخص ثالث، و خطوط لوله داده با حجم بالا طراحی شده است که روی سرورهای خودتان اجرا می‌شوند و به کدهای توسعه‌دهنده اختصاصی و اطلاعات کاربری OAuth نیاز دارند.
آیا برای اجرای جاوااسکریپت Google Ads به سرور نیاز دارم؟
نه. جاوااسکریپت Google Ads کاملاً در زیرساخت ابری Google بدون هزینه اضافی اجرا می‌شود. می‌توانید دستورگانه‌ها را بنویسید، آن‌ها را با حالت پیش‌نمایش آزمایش کنید، و آن‌ها را مستقیماً در واسط وب Google Ads زمان‌بندی کنید.
محدوده‌های اجرایی برای جاوااسکریپت Google Ads چیست؟
دستورات استاندارد در حساب‌های تکی می‌توانند تا ۳۰ دقیقه در هر اجرا اجرا شوند. دستورگان‌های حساب مدیر که از executeInParallel استفاده می‌کنند می‌توانند
تا ۶۰ دقیقه در حداکثر ۵۰ حساب فرزند اجرا شوند (وقتی تابع بازخوانی
مشخص شده باشد). اگر مهلت اسکریپت تمام شود، Google Ads همچنان تغییرات انجام‌شده
پیش‌از لغو را اعمال می‌کند. برای جزئیات کامل درباره زمان‌های اتمام مهلت، سهمیه‌ها، و محدودیت‌های بارگذاری انبوه،
محدودیت‌ها را ببینید.
آیا جاوااسکریپت Google Ads می‌تواند به میاناهای برنامه‌سازی کاربردی خارجی متصل شود؟
بله. دستورگان Google Ads شامل سرویس‌های داخلی مثل SpreadsheetApp برای
خواندن و نوشتن «کاربرگ‌نگار Google»، UrlFetchApp برای ارسال درخواست‌های HTTP به
میاناهای برنامه‌سازی کاربردی REST خارجی، و «میاناهای برنامه‌سازی کاربردی پیشرفته Google» برای ادغام با سرویس‌هایی مثل
BigQuery و YouTube است. برای جزئیات بیشتر،
میاناهای برنامه‌سازی کاربردی طرف سوم
و میاناهای برنامه‌سازی کاربردی پیشرفته Google را ببینید.
بازخورد
اگر بازخوردی درباره جاوااسکریپت Google Ads دارید، خوشحال می‌شویم آن را بشنویم! در Discord با ما تماس بگیرید.
اگر به پشتیبانی نیاز دارید، با پشتیبانی فنی دستورگان تماس بگیرید.