جاوااسکریپت Google Ads پلاتفرم خودکارسازی بدون سروری ارائه می‌دهد که به شما امکان می‌دهد بااستفاده از جاوااسکریپت مدرن (ES6+) در IDE مبتنی بر مرورگر، داده‌های Google Ads خود را به‌صورت برنامه‌نویسی‌شده مدیریت و پُرسمان کنید. با جاوااسکریپت Google Ads، می‌توانید گردش‌های کاری مدیریت حساب معمول را خودکار کنید، گزارش‌های سفارشی ایجاد کنید، و Google Ads را با منابع داده خارجی ادغام کنید—در یک حساب یا هزاران حساب—بدون نیاز به تأمین سرورها یا مدیریت اطلاعات کاربری توسعه‌دهنده.
بیشتر ویژگی‌های Google Ads ازطریق تغییر و جستجو تماس‌ها در دستورگان 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 یا میاناهای برنامه‌سازی کاربردی طرف سوم با دستورگان 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» چیست؟
دستورگان Google Ads مستقیماً در حساب Google Ads شما بااستفاده از JavaScript اجرا می‌شود، به زیرساخت سرور صفر نیاز دارد، و مجوز را به‌طور خودکار در مرورگر مدیریت می‌کند. 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 با ما تماس بگیرید.
اگر به پشتیبانی نیاز دارید، با پشتیبانی فنی دستورگان تماس بگیرید.