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

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

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

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

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

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

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

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

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

تجدر الإشارة إلى أنه من المفترض أن يكون رقم تعريف المشروع بهذا التنسيق {company}-gota-api-{number}.

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

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

تجربة لوحة بيانات Android عبر الهواء

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

إذا لم يسبق لك استخدام لوحة بيانات Android عبر الهواء، ننصحك بتجربة واجهة المستخدم قبل بدء الترميز.

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

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

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

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

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

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

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

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

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

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