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