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

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

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

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

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

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

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

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

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

التعرُّف على أساسيات 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 في واجهة برمجة تطبيقات بحث الرسم البياني المعرفي من Google

يتم ربط عمليات واجهة برمجة التطبيقات لبحث الرسم البياني المعرفي من Google مباشرةً بأفعال HTTP REST.

إليك التنسيقات المحددة لمعرّفات الموارد المنتظمة (URI) الخاصة بـ "واجهة برمجة التطبيقات للبحث للرسم البياني المعرفي من Google":

https://kgsearch.googleapis.com/v1/entities:search?query=your_query&parameters

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

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

تعرض واجهة برمجة تطبيقات بحث الرسم البياني المعرفي من Google البيانات بتنسيق JSON.

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