المتطلبات الأساسية

قبل البدء بترميز تطبيق العميل الأول، إليك بعض الإجراءات التي يجب تنفيذها إذا لم يسبق لك اتّخاذها.

الحصول على حساب Google

يجب أن يكون لديك حساب على Google من أجل إنشاء مشروع في وحدة تحكّم Google API. إذا كنت تملك حسابًا، فأنت جاهز تمامًا.

وقد تحتاج أيضًا إلى حساب منفصل على Google لأغراض الاختبار.

تجربة Google AdMob

تفترض مستندات واجهة برمجة التطبيقات هذه أنّك استخدمت Google AdMob، وأنّك على دراية بمفاهيم برمجة الويب وتنسيقات بيانات الويب.

وإذا لم تكن قد استخدمت Google AdMob، جرِّب واجهة المستخدِم قبل بدء الترميز.

إنشاء مشروع لعميلك

قبل أن تتمكّن من إرسال طلبات إلى Google AdMob، عليك إعلام Google بعميلك وتفعيل الوصول إلى واجهة برمجة التطبيقات. يمكنك إجراء ذلك باستخدام وحدة التحكم في واجهة Google API لإنشاء مشروع، وهو مجموعة مُعينة من الإعدادات ومعلومات الدخول إلى واجهة برمجة التطبيقات، وتسجيل تطبيقك.

لبدء استخدام واجهة برمجة تطبيقات AdMob، عليك أولاً استخدام أداة الإعداد التي ترشدك خلال خطوات إنشاء مشروع في وحدة التحكم في واجهة Google API وتفعيل واجهة برمجة التطبيقات وإنشاء بيانات الاعتماد.

التعرّف على أساسيات REST

REST هي نمط من بنية البرامج التي توفر نهجًا مريحًا ومتسقًا لطلب البيانات وتعديلها.

يشير الاختصار REST إلى "نقل الولاية التمثيلية". يشير سياق Google APIs إلى استخدام أفعال HTTP لاسترداد تمثيلات البيانات التي خزّنتها Google وتعديلها.

في نظام RESTful، يتم تخزين الموارد في مخزن بيانات؛ يرسل العميل طلبًا بأن يؤدي الخادم إجراءً معينًا (مثل إنشاء مورد أو استرداده أو تحديثه أو حذفه)، وينفذ الخادم الإجراء ويرسل استجابة، غالبًا في شكل تمثيل للمورد المحدد.

في واجهات برمجة التطبيقات 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

ترتبط عمليات واجهة برمجة تطبيقات AdMob مباشرةً بأفعال HTTP التي تتضمّن REST.

التنسيقات المحددة لمعرّفات الموارد المنتظمة (URI) لواجهة برمجة تطبيقات AdMob هي:

https://admob.googleapis.com/v1/resourcePath?parameters

يلخّص المستند مرجع AdMob API المجموعة الكاملة من معرّفات الموارد المنتظمة (URI) المستخدَمة لكل عملية متوافقة في واجهة برمجة التطبيقات.

التعرّف على أساسيات JSON

تعرِض واجهة برمجة تطبيقات AdMob البيانات بتنسيق JSON.

JSON (JavaScript Object Notation) هو تنسيق بيانات شائع ومستقل عن اللغة يوفّر تمثيلاً نصيًا بسيطًا لهياكل البيانات العشوائية. لمزيد من المعلومات، يمكنك الاطّلاع على json.org.