ملخّص
يجب طلب الرمز المميّز للمطوِّر والحصول على بيانات اعتماد المصادقة لاستخدام Google Ads API وإجراء طلبات البيانات من واجهة برمجة التطبيقات في حساب على "إعلانات Google". يمكنك الاطّلاع على دليل البدء السريع للحصول على مزيد من التفاصيل.
الخطوات اليدوية
يجب إكمال الخطوات التالية لاستخدام Google Ads API:
الحصول على الرمز المميز للمطوِّر
يربط الرمز المميز للمطوِّر في "إعلانات Google" تطبيقك بواجهة Google Ads API.
- اتبع الخطوات الواردة في الحصول على الرمز المميز للمطوِّر.
- بعد الاشتراك، يصبح رمزك المميّز في انتظار الموافقة.
- تأكّد من امتثال برنامجك لأحكام وشروط Google Ads API والحد الأدنى المطلوب من الوظائف (RMF). يكون الحد الأدنى المطلوب من الوظائف فقط للرموز المميّزة ذات الإذن بالوصول العادي.
يمكنك استرداد الرمز المميز للمطوِّر لحسابك الإداري في أي وقت من خلال واجهة مستخدم "إعلانات Google"، ضمن الأدوات والإعدادات > الإعداد > مركز واجهة برمجة التطبيقات.
يمكنك استخدام الرمز المميز للمطوِّر على الفور مع حساب مدير اختبار. يجب الموافقة على الرمز المميّز للمطوِّر قبل أن تتمكّن من استخدامه مع حسابات "إعلانات Google" للإنتاج.
توفّر واجهة برمجة التطبيقات مستويات الوصول التالية:
- Test
- التذكرة الأساسية
- الإذن بالوصول العادي
راجِع مستويات الوصول والاستخدام المسموح به للحصول على مزيد من المعلومات عن كل مستوى.
إنشاء حسابات اختبارية
الحسابات التجريبية غير مطلوبة، ولكنها تتيح لك إجراء طلبات بيانات من واجهة برمجة التطبيقات واختبار الرمز قبل الموافقة على الرمز المميّز للمطوِّر. اتّبِع هذه التعليمات لإنشاء حسابات اختبارية وحملات تجريبية.
اختيار مكتبة برامج
نزِّل إحدى مكتبات العملاء في Google Ads API.
ويتم تضمين عينات التعليمات البرمجية وتعليمات التثبيت مع كل مكتبة عميل.
إعداد OAuth2
يسمح OAuth2 لتطبيقك بالعمل نيابةً عن حسابك. سير العمل هذا لتطبيقات أجهزة سطح المكتب، راجع إعداد مشروع وحدة تحكم Google API لمزيد من المعلومات.
لاستخدام OAuth2 مع Google APIs، يمكنك إنشاء معرِّف عميل OAuth2 وسر العميل:
- بعد تسجيل الدخول إلى الحساب الإداري، افتح صفحة بيانات الاعتماد في وحدة تحكّم Google API.
- وسِّع القائمة المنسدلة المشاريع، ثم اختَر مشروع جديد.
- أدخِل اسمًا للمشروع، ثم انقر على إنشاء.
- في الشريط الجانبي، انقر على شاشة موافقة OAuth، ثم أدخِل المعلومات المطلوبة، وانقر على حفظ ومتابعة. يمكنك الاطِّلاع على دليل OAuth لمزيد من التفاصيل.
- في الشريط الجانبي، انقر على قواعد الإسناد > إنشاء بيانات الاعتماد > معرّف عميل OAuth، ثم اختَر تطبيق سطح المكتب.
- أدخِل اسمًا لعميلك، ثم انقر على إنشاء.
يؤدي هذا إلى إنشاء معرِّف العميل وسر العميل.
الحصول على الرمز المميّز لإعادة التحميل
وتحتاج أيضًا إلى رمز مميز لإعادة التحميل للدخول إلى Google APIs.
للحصول على رمز مميّز لإعادة التحميل، اتّبِع الخطوات الخاصة بمكتبة العملاء التي اخترتها. تختلف الخطوات لكل لغة برمجة. ويمكنك الاطلاع على نماذج المصادقة لكل مكتبة.
إجراء أول طلب بيانات من واجهة برمجة التطبيقات
اتّبِع البرنامج التعليمي للمكالمات الأولى في Google Ads API لإجراء مكالمة بسيطة.
الخطوات التلقائية
لا يمكن تنفيذ هذه العملية.