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

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

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

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

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

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

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

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

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

التعرُّف على أساسيات 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

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

قد تجد تعريفات الطريقة في مستندات معايير HTTP 1.1 مفيدة، حيث إنها تتضمن مواصفات GET وPOST وPUT وDELETE.

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

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

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

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

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

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

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

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