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