مقدمة

تُستخدَم 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. يتم تحديد مستوى الوصول إلى واجهة برمجة التطبيقات لكل رمز مميز للمطوّر، ويتحكّم هذا المستوى في عدد طلبات البيانات من واجهة برمجة التطبيقات التي يمكنك إرسالها يوميًا، بالإضافة إلى البيئة التي يمكنك إرسال الطلبات إليها.

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

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

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

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