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

أنشئ حسابًا على Google

عليك إنشاء حساب Google من أجل إنشاء مشروع في Google API Console. إذا كان لديك حساب، لست بحاجة إلى اتخاذ أي إجراءات إضافية.

ننصحك أيضًا باستخدام حساب Google منفصل لأغراض الاختبار.

تجربة Google AdMob

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

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

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

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

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

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

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

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

في نظام REST، يتم تخزين الموارد في متجر بيانات. يرسل العميل طلبًا يقضي بتنفيذ الخادم لإجراء محدد (مثلاً إنشاء مورد أو استرداده أو تعديله أو حذفه)، وينفّذ الخادم الإجراء ويرسل ردًّا غالبًا ما يكون على شكل تمثيل للمورد المحدد.

في REST API التابع لـ Google، يحدد العميل إجراءً باستخدام فعل HTTP، مثل POST أو GET أو PUT أو DELETE. ويحدد موردًا حسب معرف موارد منتظم (URI) فريد عالميًا يكون على الشكل التالي:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

بما أنّ كل الموارد تملك معرفات منتظمة لبروتوكولات HTTP يمكن الوصول إليها، يتيح REST تخزين البيانات مؤقتًا وتم تحسينه ليعمل مع بنية الويب الأساسية الموزَّعة.

قد تكون تعريفات الطرق في مستند معايير HTTP 1.1 مفيدة لك، وهي تشمل مواصفات عن GET وPOST وPUT وDELETE.

‫REST في AdMob API

ترتبط مباشرةً عمليات AdMob API بأفعال HTTP الخاصة بـ REST.

في ما يلي التنسيقات المحددة لمعرّفات الموارد المنتظمة الخاصة بـ AdMob API:

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

يمكنك العثور على تلخيص لمجموعة المعرّفات الكاملة لكل عملية متاحة في واجهة برمجة التطبيقات في مستند مرجع AdMob API.

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

يعرض AdMob API البيانات بتنسيق JSON.

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