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