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

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

الحصول على حساب 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.

في نظام 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

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

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

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

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

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

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

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