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

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

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

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

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

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

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

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

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

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

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

إذا قررت عدم استخدام مكتبات العملاء، عليك فهم أساسيات 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 في Google Knowledge Graph Search API

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

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

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

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

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

تعرض Google Knowledge Graph Search API البيانات بتنسيق JSON.

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