توفّر نصوص "إعلانات Google" البرمجية منصة أتمتة بدون خادم تتيح لك إدارة بيانات "إعلانات Google" وطلب البحث عنها آليًا باستخدام JavaScript الحديثة (الإصدار ES6 والإصدارات الأحدث) في بيئة تطوير متكاملة مستندة إلى المتصفّح. باستخدام نصوص "إعلانات Google" البرمجية، يمكنك برمجة سير عمل إدارة الحسابات الروتينية، وإنشاء تقارير مخصّصة، ودمج "إعلانات Google" مع مصادر البيانات الخارجية، على مستوى حساب واحد أو آلاف الحسابات، بدون توفير خوادم أو إدارة بيانات اعتماد المطوّرين.
تتوفّر معظم ميزات "إعلانات Google" في نصوص "إعلانات Google" البرمجية من خلال طلبات mutate وsearch. يمكنك استخدام النصوص البرمجية لإجراء ما يلي:
- إدارة الحملات والمجموعات الإعلانية والكلمات الرئيسية والإعلانات
- عدِّل عروض الأسعار والميزانيات والحالة استنادًا إلى الأداء في الوقت الفعلي أو البيانات الخارجية.
- يمكنك تنفيذ طلبات البحث باستخدام لغة طلب البحث في "إعلانات Google" (GAQL) لإنشاء تقارير مخصّصة ولوحات بيانات.
- يمكنك جدولة عمليات التنفيذ الآلية لتشغيلها كل ساعة أو يوميًا أو أسبوعيًا أو شهريًا أو عند الطلب.
- تنسيق العمليات المتعددة الحسابات في الحسابات الفرعية باستخدام نصوص الحساب الإداري البرمجية
- الربط بخدمات Google Workspace (مثل "جداول بيانات Google" وDrive) وخدمات Google Cloud (مثل BigQuery) وواجهات برمجة التطبيقات التابعة لجهات خارجية
تتضمّن نصوص "برمجة تطبيقات Google" أيضًا محدّدات الكيانات والتقارير المضمّنة.
المواصفات الفنية الرئيسية
تحدّد المواصفات الفنية التالية بيئة التنفيذ والحدود التشغيلية لنصوص "إعلانات Google" البرمجية:
| المواصفات | نص برمجي لحساب واحد | نص حساب إداري |
|---|---|---|
| مهلة التنفيذ | 30 دقيقة كحدّ أقصى |
ما يصل إلى 60 دقيقة مع executeInParallel وميزة معاودة الاتصال
(30 دقيقة كحدّ أقصى)
|
| محرّك وقت التشغيل | وقت تشغيل V8 JavaScript (الإصدار 6 من ECMAScript أو الإصدارات الأحدث) | وقت تشغيل V8 JavaScript (ECMAScript 6+) |
| الحد الأقصى لعدد العناصر التي يمكن تكرارها | 50,000 عنصر تلقائي لكل مكرّر (يتم استثناء التقارير وطلبات البحث) | 50,000 عنصر لكل حساب فرعي (يُستثنى من ذلك التقارير وطلبات البحث) |
| Parallel accounts | لا ينطبق (حساب واحد) | ما يصل إلى 50 حسابًا بالتوازي |
| الحد الأقصى للتحميل المجمّع | حجم الملف 50 ميغابايت، و1,000,000 صف | حجم الملف 50 ميغابايت، و1,000,000 صف |
| النصوص البرمجية المسموح بها | ما يصل إلى 250 نصًا برمجيًا مصرَّحًا به لكل مستخدم | ما يصل إلى 250 نصًا برمجيًا معتمدًا لكل مستخدم |
| الاستضافة والبنية الأساسية | مُدارة بالكامل من Google (بدون خادم) | مُدار بالكامل من Google (حوسبة بدون خادم) |
لمزيد من المعلومات، يُرجى الاطّلاع على الحدود القصوى.
هل نصوص "إعلانات Google" البرمجية هي المنتج المناسب لي؟
توفّر Google منتجات متعدّدة للمساعدة في برمجة حسابات "إعلانات Google". يوضّح الجدول التالي السيناريوهات الشائعة والاقتراحات لمساعدتك في اختيار المنتج المناسب لاحتياجاتك:
| السيناريو | الاقتراح | الخصائص الرئيسية |
|---|---|---|
| أنا مطوّر برامج أريد إنشاء منتج برمجي خاص بي أو الدمج مع Google Ads API. أنا مرتاح في كتابة الرموز البرمجية وإدارة البنية الأساسية للبرامج، بما في ذلك الخوادم وقواعد البيانات. | استخدِم Google Ads API. | تحكُّم كامل في واجهة برمجة التطبيقات، ومعدّل نقل بيانات أعلى، واستضافة مخصّصة، وإدارة OAuth |
| أنا مطوّر يمكنني كتابة الرموز البرمجية، ولكن أفضّل عدم إدارة البنية الأساسية للبرامج الخاصة بي. | استخدام نصوص "إعلانات Google" البرمجية | تنفيذ بدون خادم داخل "إعلانات Google"، وجدولة مبرمَجة، وبيئة تطوير متكاملة (IDE) مستندة إلى المتصفّح |
| لستُ مطوّرًا، ولكنّني على استعداد لاستثمار بعض الوقت في تعلُّم البرمجة لإجراء عمليات "إعلانات Google" آليًا. | استخدِم نصوص "إعلانات Google" البرمجية. | بنية JavaScript بسيطة، ونماذج نصوص برمجية مُعدّة مسبقًا، وميزة الإكمال التلقائي في بيئة التطوير المتكاملة (IDE)، وتمييز البنية |
| أريد إدارة حملات الفيديو آليًا. | استخدِم نصوص "إعلانات Google" البرمجية. |
إدارة حملات الفيديو مباشرةً باستخدام
AdsApp.videoCampaigns()
|
| أريد جدولة المهام لتنفيذها بدون الحاجة إلى جلسة مستخدم نشطة. | استخدام نصوص "إعلانات Google" البرمجية | تفويض OAuth2 في الخلفية مع جدولة تلقائية كل ساعة أو يوميًا أو أسبوعيًا أو شهريًا |
| أريد الوصول إلى حساباتي المتداخلة على "إعلانات Google" آليًا. | استخدِم نصوص المدير البرمجية للوصول إلى الحسابات الفرعية التي تعرض الإعلانات من نص برمجي واحد. |
التكرار التسلسلي في جميع الحسابات الفرعية أو التنفيذ المتوازي في ما يصل إلى 50 حسابًا فرعيًا باستخدام executeInParallel
|
| أريد دمج واجهات برمجة التطبيقات المملوكة لشركة Google أو التابعة لجهات خارجية في إدارة حسابي على "إعلانات Google". | استخدِم واجهات برمجة تطبيقات Google أو واجهات برمجة التطبيقات التابعة لجهات خارجية مع نصوص "إعلانات Google" البرمجية. |
خدمات Google Workspace المضمّنة (جداول بيانات Google وDrive وMail) وواجهات برمجة تطبيقات Google المتقدّمة (BigQuery و"إحصاءات Google" وYouTube) وUrlFetchApp لواجهات برمجة تطبيقات REST الخارجية
|
| أنا محلّل بيانات (أو دور مشابه) وأريد تنزيل تقارير "إعلانات Google" لإجراء المزيد من التحليل. | استخدِم خدمة نقل البيانات في BigQuery إلى "إعلانات Google". | مسار آلي مُجدوَل لبيانات الأداء مع إعلانات Google إلى BigQuery بدون الحاجة إلى كتابة رمز |
| أريد إدارة "إعلانات Google" بشكل مجمّع، ولا أمانع كتابة الرموز البرمجية. | استخدِم عمليات التحميل المجمّعة مع نصوص "إعلانات Google" البرمجية. | تحميل ملف CSV أو جدول بيانات آليًا يتضمّن ما يصل إلى 1,000,000 صف |
| أريد إدارة "إعلانات Google" بشكل مجمّع، ولكنّني لا أريد كتابة أي رمز برمجي. | استخدِم القواعد المبرمَجة أو عمليات التحميل المجمَّعة أو محرّر إعلانات Google. | أدوات واجهة المستخدم أو أجهزة الكمبيوتر المكتبي بدون استخدام رمز لإجراء التعديلات المجمّعة والقواعد المُجدوَلة |
المتطلبات الأساسية
كل ما تحتاجه هو معرفة أساسية بلغة JavaScript، إذ يساعدك بيئة التطوير المتكاملة في تمييز الصيغة وإكمالها تلقائيًا ومعاينتها. كل ما تحتاج إليه هو حساب على إعلانات Google للبدء في كتابة أول نص برمجي لك.
الأسئلة الشائعة
يمكنك العثور على إجابات عن الأسئلة الشائعة حول بنية نصوص "إعلانات Google" البرمجية وحدود التنفيذ وعمليات الدمج.
ما هي نصوص "إعلانات Google" البرمجية؟
توفّر نصوص "إعلانات Google" البرمجية بيئة أتمتة بدون خادم ضِمن "إعلانات Google". وتسمح للمعلنين والمطوّرين بكتابة رمز JavaScript لطلب مقاييس الأداء وإنشاء الحملات وتعديلها وتعديل عروض الأسعار والميزانيات والربط بواجهات برمجة التطبيقات الخارجية بدون ضبط الخوادم أو إدارة رموز OAuth المميّزة أو الدفع مقابل البنية الأساسية.
كيف تختلف نصوص "إعلانات Google" البرمجية عن Google Ads API؟
يتم تشغيل نصوص "إعلانات Google" البرمجية مباشرةً في حساب "إعلانات Google" باستخدام JavaScript، ولا تتطلّب أي بنية أساسية للخادم، وتتعامل مع التفويض تلقائيًا في المتصفّح. Google Ads API هي واجهة REST وgRPC API مصمَّمة للتطبيقات المؤسسية الأكبر حجمًا والأدوات التابعة لجهات خارجية ومسارات البيانات الكبيرة الحجم التي تعمل على الخوادم الخاصة بك وتتطلّب رموزًا مميّزة مخصّصة للمطوّرين وبيانات اعتماد OAuth.
هل أحتاج إلى خادم لتشغيل نصوص "إعلانات Google" البرمجية؟
لا، تعمل نصوص "إعلانات Google" البرمجية بالكامل على البنية الأساسية السحابية من Google بدون أي تكلفة إضافية. يمكنك إنشاء نصوص برمجية واختبارها باستخدام وضع المعاينة وجدولتها مباشرةً في واجهة الويب الخاصة بـ "إعلانات Google".
ما هي حدود التنفيذ لنصوص "إعلانات Google" البرمجية؟
يمكن تشغيل النصوص البرمجية العادية في الحسابات الفردية لمدة تصل إلى 30 دقيقة لكل عملية تنفيذ. يمكن تنفيذ نصوص الحساب الإداري البرمجية التي تستخدم executeInParallel لمدة تصل إلى 60 دقيقة على ما يصل إلى 50 حسابًا فرعيًا (عند تحديد دالّة رد الاتصال). إذا انتهت مهلة نص برمجي، ستطبّق "إعلانات Google" أي تغييرات تم إجراؤها قبل الإلغاء. يمكنك الاطّلاع على الحدود القصوى
لمعرفة التفاصيل الكاملة عن المهلات والحصص والحدود القصوى للتحميل المجمّع.
هل يمكن لنصوص "إعلانات Google" البرمجية الاتصال بواجهات برمجة تطبيقات خارجية؟
نعم. تتضمّن نصوص "إعلانات Google" البرمجية خدمات مدمجة، مثل SpreadsheetApp
لقراءة "جداول بيانات Google" والكتابة فيها، وUrlFetchApp لإرسال طلبات HTTP إلى
واجهات برمجة تطبيقات REST الخارجية، وواجهات برمجة تطبيقات Google المتقدّمة للدمج مع خدمات
مثل BigQuery وYouTube. لمزيد من التفاصيل، يُرجى الاطّلاع على واجهات برمجة التطبيقات التابعة لجهات خارجية وواجهات برمجة تطبيقات Google المتقدّمة.
الملاحظات
إذا كانت لديك أي ملاحظات حول نصوص "إعلانات Google" البرمجية، يُرجى إعلامنا بها. يمكنك التواصل معنا على Discord.
إذا كنت بحاجة إلى المساعدة، يُرجى التواصل مع فريق الدعم الفني الخاص بنصوص "إعلانات Google" البرمجية.