عندما يطلب التطبيق بيانات عامة، لا يحتاج التطبيق إلى تفويض، ولكن يجب أن يكون مصحوبًا بمعرّف، مثل مفتاح واجهة برمجة التطبيقات.
يحتاج تطبيقك إلى تعريف نفسه في كل مرة يُرسل فيه طلبًا إلى واجهة برمجة تطبيقات بحث الرسم البياني للمعرفة من Google، من خلال تضمين مفتاح واجهة برمجة التطبيقات مع كل طلب.
الحصول على مفتاح واجهة برمجة تطبيقات واستخدامه
للحصول على مفتاح واجهة برمجة تطبيقات:
- افتح صفحة بيانات الاعتماد في وحدة تحكم واجهة برمجة التطبيقات.
-
تتيح واجهة برمجة التطبيقات هذه استخدام نوعَين من بيانات الاعتماد.
أنشئ بيانات الاعتماد المناسبة لمشروعك:
-
OAuth 2.0: عندما يطلب تطبيقك بيانات المستخدم الخاصة، يجب أن يرسل رمز OAuth 2.0 المميز مع الطلب. يرسل التطبيق أولاً معرِّف عميل وربما سر عميل للحصول على رمز مميز. يمكنك إنشاء بيانات اعتماد OAuth 2.0 لتطبيقات الويب أو حسابات الخدمة أو التطبيقات المُثبَّتة.
ملاحظة: نظرًا لأن واجهة برمجة التطبيقات هذه لا تتضمن أي طرق تتطلب تفويض OAuth 2.0، قد تحتاج فقط إلى الحصول على مفاتيح واجهة برمجة التطبيقات الموضحة أدناه. ومع ذلك، إذا كان تطبيقك يستدعي واجهات برمجة تطبيقات أخرى تتطلب تفويض المستخدم، ما زلت بحاجة إلى بيانات اعتماد OAuth 2.0.
لمزيد من المعلومات، راجع وثائق OAuth 2.0.
-
مفاتيح واجهة برمجة التطبيقات: يجب أن يرسل الطلب الذي لا يوفر رمزًا مميزًا لبروتوكول OAuth 2.0 مفتاح واجهة برمجة التطبيقات. يحدد المفتاح مشروعك ويوفر إمكانية الوصول إلى واجهة برمجة التطبيقات والحصة والتقارير.
تدعم واجهة برمجة التطبيقات عدة أنواع من القيود على مفاتيح واجهة برمجة التطبيقات. إذا لم يكن مفتاح واجهة برمجة التطبيقات الذي تحتاجه متوفرًا، يمكنك إنشاء مفتاح واجهة برمجة تطبيقات في وحدة التحكّم بالنقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات. يمكنك حصر المفتاح قبل استخدامه في الإنتاج من خلال النقر على تقييد المفتاح واختيار أحد القيود.
-
للحفاظ على أمان مفاتيح واجهة برمجة التطبيقات، اتبع أفضل الممارسات لاستخدام مفاتيح واجهة برمجة التطبيقات بشكل آمن.
بعد توفّر مفتاح واجهة برمجة تطبيقات، يمكن لتطبيقك إلحاق معلمة طلب البحث
key=yourAPIKey بجميع عناوين URL للطلبات.
يعتبر مفتاح واجهة برمجة التطبيقات آمنًا للتضمين في عناوين URL، ولا يحتاج إلى أي تشفير.