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

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

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

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

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

إضافة المشروع إلى القائمة البيضاء

لا تتوفّر واجهة برمجة التطبيقات Android Over The Air إلا للمشاريع المضافة إلى القائمة البيضاء. إذا لم يكن مشروعك مدرجًا في القائمة البيضاء، ستظهر لك أخطاء 404 عند محاولة استخدامه.

للحصول على القائمة البيضاء، أرسِل رسالة إلكترونية إلى مدير الحسابات التقنية (TAM) في Google لإدراج رقم تعريف المشروع الجديد في القائمة البيضاء.

ويمكن العثور على رقم تعريف المشروع في لوحة بيانات Cloud. راجِع مستند المساعدة هذا للاطّلاع على مزيد من المعلومات.

لاحظ أن رقم تعريف المشروع يجب أن يكون بهذا التنسيق بشكل مثالي {company}-gota-api-{number}

بعد إدراجك في القائمة البيضاء، يمكنك enable Android Over The Air API لمشروعك والاطّلاع على طريقة التفويض للحصول على تفاصيل حول الوصول إليه.

تجدر الإشارة إلى أنّ رقم تعريف المشروع الذي قدّمته فقط سيتمكّن من استخدام واجهة برمجة التطبيقات Android Over The Air. ننصحك بشدة بإنشاء حساب خدمة (على النحو الموضَّح في التفويض) لاستخدام واجهة برمجة التطبيقات بدلاً من استخدام أي حسابات شخصية.

تجربة لوحة بيانات Android Over The Air

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

إذا لم يسبق لك استخدام "لوحة بيانات Android Over The Air"، جرِّب واجهة المستخدم قبل بدء الترميز.

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

هناك طريقتان لاستدعاء واجهة برمجة التطبيقات:

إذا قررت عدم استخدام مكتبات العملاء، فستحتاج إلى فهم أساسيات 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 في واجهة برمجة تطبيقات Android Over The Air

ترتبط عمليات Android Over The Air API مباشرةً بأفعال HTTP التي تتضمّن REST.

التنسيقات المحددة لمعرّفات الموارد المنتظمة (URI) لواجهة Android Over The Air API هي:

https://www.googleapis.com/android/over-the-air/v1/resourcePath?parameters

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

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

تعرض واجهة برمجة التطبيقات Android Over The Air البيانات بتنسيق JSON.

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