الحصول على مفتاح واجهة برمجة التطبيقات

اختَر النظام الأساسي: Android iOS JavaScript

الآن بعد أن تم إعداد الفوترة ومشروع، وتفعيل SDK، وتثبيت مدير التبعية المفضل لديك والبرامج الأخرى، فأنت جاهز لإنشاء مفتاح واجهة برمجة التطبيقات وإضافته وتقييده.

إنشاء مفاتيح واجهة برمجة التطبيقات

مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.

لإنشاء مفتاح واجهة برمجة التطبيقات:

وحدة التحكم

1. انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.

   الانتقال إلى صفحة "بيانات الاعتماد"

2. في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
   يعرض مربّع الحوار تم إنشاء مفتاح واجهة برمجة التطبيقات مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا.
3. انقر على إغلاق.
   يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
   (احرص على تقييد مفتاح واجهة برمجة التطبيقات قبل استخدامه في مرحلة الإنتاج.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

يمكنك الاطّلاع على مزيد من المعلومات عن حزمة تطوير البرامج (SDK) في Google Cloud، وتثبيت حزمة تطوير البرامج (SDK) في السحابة الإلكترونية والأوامر التالية:

• gcloud alpha services api-keys create

ستحتاج إلى مفتاح واجهة برمجة التطبيقات هذا عند إنشاء مشروع Xcode كما هو موضّح في إعداد مشروع Xcode.

ملاحظة: يمكنك استخدام مفتاح واجهة برمجة التطبيقات نفسه لحزمة تطوير برامج "خرائط Google" على أجهزة iOS وحزمة تطوير برامج "الأماكن" على نظام التشغيل iOS.

تقييد مفاتيح واجهة برمجة التطبيقات

تنصح Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات عن طريق حصر استخدامها على واجهات برمجة التطبيقات المطلوبة لتطبيقك فقط. يؤدي تقييد مفاتيح واجهة برمجة التطبيقات إلى إضافة أمان إلى تطبيقك عن طريق حمايته من الطلبات غير المضمونة. لمزيد من المعلومات، يُرجى الاطِّلاع على أفضل ممارسات أمان واجهة برمجة التطبيقات.

عند حظر مفتاح واجهة برمجة تطبيقات في Cloud Console، تلغي قيود التطبيقات أي واجهات برمجة تطبيقات تم تفعيلها ضمن قيود واجهة برمجة التطبيقات. اتّبِع أفضل الممارسات من خلال إنشاء مفتاح واجهة برمجة تطبيقات منفصل لكل تطبيق ولكل نظام أساسي يتوفّر عليه هذا التطبيق.

لتقييد مفتاح واجهة برمجة التطبيقات:

وحدة التحكم

1. انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.

   الانتقال إلى صفحة "بيانات الاعتماد"

2. اختَر مفتاح واجهة برمجة التطبيقات الذي تريد فرض قيود عليه. ستظهر صفحة خصائص مفتاح واجهة برمجة التطبيقات.
3. ضمن القيود الرئيسية، اضبط القيود التالية:
• قيود التطبيقات:
1. اختَر تطبيقات iOS.
2. لقبول الطلبات من تطبيق iOS الذي يتضمّن معرّف الحزمة الذي تقدّمه، اختَر معرّف حزمة iOS المناسب من القائمة.
• قيود واجهة برمجة التطبيقات:
1. انقر على تقييد المفتاح.
2. اختر حزمة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل iOS من القائمة المنسدلة اختيار واجهات برمجة التطبيقات. إذا لم تكن حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS مدرَجة، يجب تفعيلها.
4. لإنهاء التغييرات التي أجريتها، انقر على حفظ.
   

Cloud 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="maps-ios-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

يمكنك الاطّلاع على مزيد من المعلومات عن حزمة تطوير البرامج (SDK) في Google Cloud، وتثبيت حزمة تطوير البرامج (SDK) في السحابة الإلكترونية والأوامر التالية:

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

الآن بعد أن حصلت على مفتاح واجهة برمجة التطبيقات لحزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS، أصبحت جاهزًا للبدء.

الخطوات التالية

والآن، وبعد أن أصبح لديك مفتاح واجهة برمجة التطبيقات، يمكنك إنشاء مشروع Xcode وضبطه على النحو الموضّح في إعداد مشروع Xcode.