جاوااسکریپت 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، زمان‌بندی خودکار، محیط توسعه یکپارچه مبتنی بر مرورگر. |
| من توسعه‌دهنده نیستم، اما مایلم مدتی را صرف یادگیری برنامه‌نویسی برای خودکارسازی 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 برای APIهای REST خارجی.
|
| من تحلیل‌گر داده (یا نقش مشابه) هستم که می‌خواهم گزارش‌های 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 ارائه می‌دهد. این اسکریپت‌ها به تبلیغ‌کنندگان و توسعه‌دهندگان اجازه می‌دهند تا کد جاوا اسکریپت بنویسند تا سنجه‌های عملکرد را جستجو کنند، پویش‌ها را ایجاد و اصلاح کنند، پیشنهادهای قیمت و بودجه‌ها را به‌روزرسانی کنند، و بدون پیکربندی سرورها، مدیریت کردن توکن‌های OAuth، یا پرداخت هزینه برای زیرساخت، به میاناهای برنامه‌سازی کاربردی خارجی متصل شوند.
جاوااسکریپت Google Ads چه تفاوتی با Google Ads API دارد؟
جاوااسکریپت‌های Google Ads مستقیماً در حساب Google Ads شما بااستفاده از جاوااسکریپت اجرا می‌شوند، به هیچ زیرساخت سروری نیاز ندارند، و مجوز را به‌طور خودکار در مرورگر مدیریت می‌کنند. Google Ads API یک API از نوع REST و gRPC است که برای برنامه‌های سازمانی در مقیاس بزرگ‌تر، ابزارهای شخص ثالث، و خطوط لوله داده با حجم بالا طراحی شده است که روی سرورهای خودتان اجرا می‌شوند و به کدهای توسعه‌دهنده اختصاصی و اطلاعات کاربری OAuth نیاز دارند.
آیا برای اجرای جاوااسکریپت Google Ads به سرور نیاز دارم؟
نه. جاوااسکریپت Google Ads کاملاً در زیرساخت ابری Google بدون هزینه اضافی اجرا می‌شود. می‌توانید اسکریپت‌ها را بنویسید، آن‌ها را با حالت پیش‌نمایش آزمایش کنید، و آن‌ها را مستقیماً در میانای وب Google Ads زمان‌بندی کنید.
محدودیت‌های اجرایی برای جاوااسکریپت Google Ads چیست؟
دستورات استاندارد در حساب‌های فردی می‌توانند تا ۳۰ دقیقه در هر اجرا اجرا شوند. دستورگان‌های حساب مدیر که از executeInParallel استفاده می‌کنند می‌توانند
تا ۶۰ دقیقه در حداکثر ۵۰ حساب فرزند اجرا شوند (وقتی تابع بازخوانی
مشخص شده باشد). اگر مهلت اسکریپت تمام شود، Google Ads همچنان تغییرات ایجادشده
قبل‌از لغو را اعمال می‌کند. برای جزئیات کامل درباره زمان‌های اتمام مهلت، سهمیه‌ها، و محدودیت‌های بارگذاری انبوه،
محدودیت‌ها را ببینید.
آیا جاوااسکریپت Google Ads می‌تواند به میاناهای برنامه‌سازی کاربردی خارجی متصل شود؟
بله. جاوااسکریپت Google Ads شامل سرویس‌های داخلی مانند SpreadsheetApp برای خواندن و نوشتن «کاربرگ‌نگار Google»، UrlFetchApp برای ارسال درخواست‌های اچ‌تی‌تی‌پی به میاناهای برنامه‌سازی کاربردی REST خارجی، و میاناهای برنامه‌سازی کاربردی پیشرفته Google برای ادغام با سرویس‌هایی مانند BigQuery و YouTube است. برای جزئیات بیشتر،
میاناهای برنامه‌سازی کاربردی طرف سوم
و میاناهای برنامه‌سازی کاربردی پیشرفته Google را ببینید.
بازخورد
اگر بازخوردی درباره جاوااسکریپت Google Ads دارید، خوشحال می‌شویم آن را بشنویم! در Discord با ما تماس بگیرید.
اگر به پشتیبانی نیاز دارید، با پشتیبانی فنی scripts تماس بگیرید.