قبل أن تتمكن من بدء ترميز تطبيق العميل الأول، هناك بعض الإجراءات التي عليك تنفيذها، إذا لم تكن قد فعلت ذلك من قبل.
الحصول على حساب Google
تحتاج إلى حساب Google من أجل إنشاء مشروع في وحدة تحكم واجهة برمجة تطبيقات Google. إذا كنت قد أنشأت حسابًا، هذا يعني أنك جاهز للبدء.
وقد ترغب أيضًا في الحصول على حساب Google منفصل لأغراض الاختبار.
تجربة استخدام Google AdMob
تفترض مستندات واجهة برمجة التطبيقات هذه أنك استخدمت Google AdMob وأنك تفهم مفاهيم برمجة الويب وتنسيقات بيانات الويب.
إذا لم تكن قد استخدمت Google AdMob، جرّب واجهة المستخدم قبل البدء في الترميز.
إنشاء مشروع لعميلك
قبل أن تتمكن من إرسال طلبات إلى Google AdMob، عليك إخبار Google عن عميلك وتفعيل الوصول إلى واجهة برمجة التطبيقات. يمكنك إجراء ذلك باستخدام وحدة تحكّم Google API لإنشاء مشروع، وهو مجموعة محدّدة من الإعدادات ومعلومات الوصول إلى واجهة برمجة التطبيقات، وتسجيل تطبيقك.
لبدء استخدام واجهة برمجة تطبيقات AdMob، يجب أولاً استخدام أداة الإعداد، التي ترشدك خلال إنشاء مشروع في وحدة تحكم واجهة برمجة تطبيقات Google، وتمكين واجهة برمجة التطبيقات، وإنشاء بيانات الاعتماد.
التعرُّف على أساسيات REST
وتمثّل REST أسلوب في تصميم البرامج يوفر منهجًا مريحًا ومتسقًا لطلب البيانات وتعديلها.
مصطلح REST هو اختصار يشير إلى &&نقل الممثّلين عن الدولة. في سياق Google APIs، يشير ذلك إلى استخدام أفعال HTTP لاسترداد تمثيلات البيانات المُخزنة بواسطة Google وتعديلها.
في نظام REST، يتم تخزين الموارد في مخزن بيانات، ويرسل العميل طلبًا بأن يجري الخادم إجراءً معينًا (مثل إنشاء مورد أو استرداده أو تحديثه أو حذفه)، ويجري الخادم الإجراء ويرسل استجابة، وغالبًا في شكل تمثيل للمورد المحدد.
في واجهات برمجة تطبيقات RESTful في Google، يحدِّد العميل إجراءً باستخدام فعل HTTP مثل POST أو GET أو PUT أو DELETE. تحدد الموارد موردًا معرف موارد منتظم (URI) فريدًا من نوعه بالصيغة التالية:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
نظرًا لأن جميع موارد واجهة برمجة التطبيقات تحتوي على معرفات الموارد المنتظمة (URI) التي يمكن الوصول إليها عبر HTTP، فإن REST يمكّن التخزين المؤقت للبيانات ويتم تحسينه للعمل مع البنية الأساسية الموزَّعة على الويب.
قد تجد تعريفات الطرق في مستندات معايير HTTP 1.1 مفيدة، وتتضمّن مواصفات GET وPOST وPUT وDELETE.
REST في AdMob API
يتم ربط عمليات AdMob API مباشرةً بأفعال HTTP REST.
في ما يلي أشكال معرّفات الموارد المنتظمة (URI) لواجهة برمجة تطبيقات AdMob:
https://admob.googleapis.com/v1/resourcePath?parameters
وقد تم تلخيص المجموعة الكاملة من معرفات الموارد المنتظمة (URI) المستخدمة لكل عملية معتمدة في واجهة برمجة التطبيقات في مستند مرجع واجهة برمجة تطبيقات AdMob.
تعرّف على أساسيات JSON
تعرض واجهة برمجة تطبيقات AdMob البيانات بتنسيق JSON.
JSON (JavaScript Object Notation) هو تنسيق بيانات شائع غير مستقل عن اللغة، ويقدم تمثيلاً نصيًا بسيطًا لبنيات البيانات العشوائية. لمزيد من المعلومات، يمكنك الاطّلاع على json.org.