مقدمة

تُستخدم Google Ads API لإدارة حسابات وحملات "إعلانات Google" الكبيرة أو المعقدة. يمكنك إنشاء برنامج يدير الحسابات من مستوى العميل إلى مستوى الكلمة الرئيسية. تتضمن بعض حالات الاستخدام النموذجية ما يلي:

  • إدارة الحساب بشكل مبرمَج
  • إعداد التقارير المخصّصة
  • إدارة الإعلانات استنادًا إلى المستودع
  • إدارة استراتيجيات عروض الأسعار الذكية

هل Google Ads API هو المنتج المناسب لي؟

توفّر Google منتجات متعددة للمساعدة في برمجة حسابات "إعلانات Google". وفيما يلي بعض السيناريوهات الشائعة وقائمة منتجات Google التي قد تناسب احتياجاتك على أفضل وجه.

السيناريو الإجراء المقترَح
أنا مطوّر برامج وأريد إنشاء منتج برمجي خاص بي أو التكامل مع Google Ads API. وأجيد كتابة الرموز البرمجية وإدارة البنية الأساسية للبرامج، بما في ذلك الخوادم وقاعدة البيانات. استخدام Google Ads API
أنا مطوّر برامج بارع في كتابة الرموز البرمجية، ولكنّني أفضّل عدم إدارة البنية الأساسية البرمجية الخاصة بي. استخدِم نصوص "إعلانات Google" البرمجية.
أنا لست مطوّر برامج، لكنّني على استعداد لاستثمار بعض الوقت في تعلُّم البرمجة لتشغيل "إعلانات Google" آليًا. استخدِم نصوص "إعلانات Google" البرمجية.
أنا محلل بيانات (أو دور مشابه) وأريد تنزيل تقارير "إعلانات Google" لمزيد من التحليل. استخدِم خدمة "نقل البيانات في BigQuery". يتوفّر الدعم لعمليات النقل في "إعلانات Google".
أريد إدارة "إعلانات Google" بشكلٍ مجمّع، ولكن لا أريد كتابة أي رمز. استخدِم القواعد المبرمَجة أو التحميلات المجمّعة أو محرّر إعلانات Google.

المتطلّبات الأساسية

لإجراء طلب بيانات من Google Ads API، يجب توفّر التفاصيل التالية. تعلمك بقية هذا البرنامج التعليمي كيفية الحصول على كل عنصر من هذه العناصر.

  • حساب إداري على "إعلانات Google": يجب أن يكون لديك حساب إداري على "إعلانات Google" للتقدّم بطلب لاستخدام Google Ads API.
  • الرمز المميز للمطوِّر: يتيح هذا الرمز المميّز لتطبيقك الربط بـ Google Ads API. يتم تخصيص مستوى وصول إلى واجهة برمجة التطبيقات (API) لكل رمز مميز للمطوِّر تتحكم في عدد طلبات البيانات من واجهة برمجة التطبيقات التي يمكنك إجراؤها يوميًا بالإضافة إلى البيئة التي يمكنك إجراء الاتصالات بها.

  • مشروع وحدة التحكم في واجهة Google API: يُستخدَم المشروع لإنشاء معرِّف عميل OAuth 2.0 وسر لتطبيقك. ويمكن بعد ذلك استخدام رقم التعريف والرمز السرّي لإنشاء بيانات اعتماد OAuth 2.0 اللازمة في طلبات البيانات من واجهة برمجة التطبيقات لحساب "إعلانات Google". يمكّن المشروع أيضًا واجهة برمجة التطبيقات من قبول الطلبات.

  • حساب عميل على "إعلانات Google": هذا هو الحساب الذي تُجري استدعاءات من واجهة برمجة التطبيقات ضده. يجب الحصول على الأذونات اللازمة للعمل على هذا الحساب، مثل استرجاع التقارير أو إجراء تغييرات على الحملات.

    ستحتاج أيضًا إلى رقم الحساب المكون من 10 أرقام للحساب الذي تُجري طلبات بيانات من واجهة برمجة التطبيقات إليه. يتم عرض هذا في واجهة الويب لبرنامج "إعلانات Google" على شكل 123-456-7890. يتم تمرير رقم الحساب هذا كمعلمة إلى طلب استدعاء واجهة برمجة التطبيقات مع "إعلانات Google" بدون الواصلات: 1234567890.

  • أدوات الدعم ومكتبات العملاء: يمكن أن تساعدك هذه المجموعة من الأدوات في الدمج مع واجهة برمجة التطبيقات بسرعة أكبر.