عندما يطلب تطبيقك بيانات علنية، ليس من الضروري الموافقة على الطلب، ولكن يجب أن يكون مصحوبًا بمعرّف، مثل مفتاح واجهة برمجة التطبيقات.
يحتاج تطبيقك إلى تعريف نفسه في كل مرة يرسل فيها طلبًا إلى واجهة برمجة تطبيقات بحث الرسم البياني المعرفي من 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 بدون الحاجة إلى أيّ ترميز.