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