تتم حماية منتجات "منصة خرائط Google" من الاستخدام غير المصرّح به من خلال حظر طلبات البيانات من واجهة برمجة التطبيقات. إلى أولئك الذين يقدمون بيانات اعتماد مصادقة مناسبة. بيانات الاعتماد هذه في شكل مفتاح واجهة برمجة التطبيقات - وهو سلسلة أبجدية رقمية فريدة تربط حساب الفوترة في Google المشروع، وباستخدام واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK) المحددة.
يوضِّح هذا الدليل كيفية إنشاء مفتاح واجهة برمجة التطبيقات وتقييده واستخدامه في "منصة خرائط Google".
إنشاء مفاتيح واجهة برمجة التطبيقات
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.
لإنشاء مفتاح واجهة برمجة التطبيقات:
وحدة التحكّم
-
انتقل إلى Google Maps Platform > بيانات الاعتماد.
-
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
يعرض مربّع الحوار مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا. -
انقر على إغلاق.
يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
(تذكَّر تقييد واجهة برمجة التطبيقات قبل استخدامه في الإنتاج).
SDK للسحاب
gcloud alpha services api-keys create \
--project "PROJECT" \
--display-name "DISPLAY_NAME"
يمكنك قراءة المزيد عن حزمة تطوير البرامج (SDK) في Google Cloud , تثبيت Cloud SDK ، بالإضافة إلى الأوامر التالية:
تقييد مفاتيح واجهة برمجة التطبيقات
تنصح Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات من خلال حصر استخدامها على تلك المفاتيح واجهات برمجة التطبيقات المطلوبة لتطبيقك. تؤدي القيود المفروضة على مفاتيح واجهة برمجة التطبيقات إلى تعزيز أمان تطبيقك من خلال حميته من الطلبات غير المبررة. لمزيد من المعلومات، يُرجى مراجعة أفضل ممارسات أمان واجهة برمجة التطبيقات.
لتقييد مفتاح واجهة برمجة التطبيقات:
وحدة التحكّم
-
انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.
- اختَر مفتاح واجهة برمجة التطبيقات الذي تريد فرض قيود عليه. ستظهر لك صفحة خاصية مفتاح واجهة برمجة التطبيقات.
- ضمن قيود المفاتيح، اضبط القيود التالية:
- قيود التطبيقات:
- لقبول الطلبات من قائمة عناوين IP التي تقدّمها لخادم الويب، اختَر عناوين IP (خوادم الويب ومهام cron وما إلى ذلك) من قائمة قيود التطبيق: حدِّد عنوانًا واحدًا أو أكثر من عناوين IPv4 أو IPv6، أو الشبكة الفرعية باستخدام تدوين CIDR. يجب أن تتطابق عناوين IP مع عنوان المصدر الذي ترصده خوادم Google Maps Platform. في حال استخدام شبكة ترجمة العنوان (NAT)، ويتطابق هذا عادةً مع عنوان IP العلني لجهازك.
- قيود واجهة برمجة التطبيقات:
- انقر على تقييد المفتاح.
- اختَر Places Insights API من القائمة المنسدلة اختيار واجهات برمجة التطبيقات إذا لم تكن واجهة برمجة تطبيقات إحصاءات الأماكن مُدرجة، فيجب تفعيلها
- لإنهاء التغييرات، انقر على حفظ.
SDK للسحاب
إدراج المفاتيح الحالية
gcloud services api-keys list --project="PROJECT"
محو القيود الحالية على المفتاح الحالي.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--clear-restrictions
فرض قيود جديدة على المفتاح الحالي.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--api-target="areainsights.googleapis.com"
--allowed-ips="IP_ADDRESS"
يمكنك قراءة المزيد عن حزمة تطوير البرامج (SDK) في Google Cloud , تثبيت Cloud SDK ، بالإضافة إلى الأوامر التالية:
إضافة مفتاح واجهة برمجة التطبيقات إلى طلبك
يجب تضمين مفتاح واجهة برمجة تطبيقات مع كل طلب من طلب Places Insights API. في المثال التالي،
استبدل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات الخاص بك.
https://areainsights.googleapis.com/v1:computeInsights?key=YOUR_API_KEY
يجب توفير بروتوكول HTTPS للطلبات التي تستخدم مفتاح واجهة برمجة التطبيقات.