إعداد الوصول إلى إعلانات Google API

ملخّص

يجب طلب الرمز المميز للمطوِّر والحصول على بيانات اعتماد المصادقة لاستخدام Google Ads API وإجراء طلبات بيانات من واجهة برمجة التطبيقات في حساب على "إعلانات Google". يمكنك الاطّلاع على دليل البدء السريع للحصول على مزيد من التفاصيل.

الخطوات اليدوية

لاستخدام Google Ads API، أكمِل الخطوات التالية:

الحصول على الرمز المميز للمطوِّر

يعمل الرمز المميز للمطوِّر في "إعلانات Google" على ربط تطبيقك بواجهة Google Ads API.

  1. اتّبِع الخطوات الواردة في المقالة الحصول على الرمز المميّز للمطوِّر.
  2. بعد الاشتراك، في انتظار الموافقة على رمزك المميّز.
  3. تأكّد من التزام برامجك بأحكام وشروط Google Ads API والحد الأدنى المطلوب من الوظائف (RMF). يلزم استخدام الحد الأدنى المطلوب من الوظائف فقط للرموز المميزة ذات "الوصول العادي"

يمكنك استرداد الرمز المميز للمطوِّر لحسابك الإداري في أي وقت من خلال واجهة مستخدم "إعلانات Google"، ضمن الأدوات والإعدادات > الإعداد > مركز واجهة برمجة التطبيقات.

يمكنك استخدام الرمز المميز للمطوِّر على الفور مع حساب إداري تجريبي. يجب أن تتم الموافقة على الرمز المميز للمطوِّر قبل أن تتمكّن من استخدامه مع حسابات "إعلانات Google" للإنتاج.

توفر واجهة برمجة التطبيقات مستويات الوصول التالية:

  • Test
  • التذكرة الأساسية
  • الإذن بالوصول العادي

راجع مستويات الوصول والاستخدام المسموح به للحصول على مزيد من المعلومات عن كل مستوى.

إنشاء حسابات اختبارية

لا حاجة إلى استخدام حسابات الاختبار، ولكنّها تتيح لك إجراء طلبات بيانات من واجهة برمجة التطبيقات واختبار الرمز البرمجي قبل الموافقة على الرمز المميز للمطوِّر. اتّبِع هذه التعليمات لإنشاء حسابات اختبارية وحملات اختبارية.

اختيار مكتبة برامج

نزِّل إحدى مكتبات عملاء Google Ads API.

يتم تضمين عينات التعليمات البرمجية وتعليمات التثبيت مع كل مكتبة عميل.

إعداد OAuth2

يسمح بروتوكول OAuth2 لتطبيقك بالعمل نيابةً عن حسابك. سير العمل هذا متعلق بتطبيقات أجهزة الكمبيوتر المكتبي، راجِع ضبط مشروع وحدة تحكُّم Google API للحصول على مزيد من المعلومات.

لاستخدام OAuth2 مع Google APIs، أنشئ معرِّف عميل OAuth2 وسر عميل:

  1. بعد تسجيل الدخول إلى حسابك الإداري، افتح صفحة بيانات اعتماد وحدة تحكُّم Google API.
  2. وسِّع القائمة المنسدلة المشاريع، ثم اختَر مشروع جديد.
  3. أدخِل اسمًا للمشروع، ثم انقر على إنشاء.
  4. في الشريط الجانبي، انقر على شاشة موافقة OAuth، ثم أدخِل المعلومات المطلوبة، وانقر على حفظ ومتابعة. راجِع دليل OAuth للحصول على مزيد من التفاصيل.
  5. في الشريط الجانبي، انقر على بيانات الاعتماد > إنشاء بيانات الاعتماد > رقم تعريف عميل OAuth، ثم اختَر تطبيق الكمبيوتر المكتبي.
  6. أدخِل اسمًا لعميلك، ثم انقر على إنشاء.

يؤدّي هذا إلى إنشاء معرِّف العميل وسر العميل.

الحصول على الرمز المميز لإعادة التحميل

وتحتاج أيضًا إلى رمز مميّز لإعادة التحميل للوصول إلى Google APIs.

للحصول على رمز مميّز للتحديث، اتّبِع الخطوات الموضّحة في مكتبة البرامج التي اخترتها. تختلف الخطوات لكل لغة برمجة. راجع نماذج المصادقة لكل مكتبة.

إجراء أول طلب بيانات من واجهة برمجة التطبيقات

اتّبِع البرنامج التعليمي للمكالمات الأولى في Google Ads API لإجراء مكالمة بسيطة.

الخطوات التلقائية

غير متاح لهذه العملية.