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

اختيار النظام الأساسي: Android iOS JavaScript خدمة الويب

قبل البدء

قبل البدء في استخدام حزمة تطوير برامج "الأماكن" لأجهزة iOS، يجب أن يكون لديك مشروع يتضمن حساب فوترة مع تفعيل حزمة تطوير برامج الأماكن لأجهزة iOS. للمزيد من المعلومات، يُرجى الاطّلاع على الإعداد في Cloud Console.

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

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

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

وحدة التحكّم

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

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

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

Cloud SDK

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

يمكنك الاطّلاع على مزيد من المعلومات عن Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:

• gcloud alpha services api-keys create

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

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

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

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

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

وحدة التحكّم

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

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

2. اختَر مفتاح واجهة برمجة التطبيقات الذي تريد وضع قيود عليه. ستظهر لك صفحة خاصية مفتاح واجهة برمجة التطبيقات.
3. ضمن قيود المفاتيح، اضبط القيود التالية:
• قيود التطبيقات:
1. اختَر تطبيقات iOS.
2. لقبول الطلبات من تطبيق iOS الذي يتضمّن معرّف الحزمة الذي تقدّمه، اختَر معرّف حزمة iOS المناسب من القائمة.
• قيود واجهة برمجة التطبيقات:
1. انقر على تقييد المفتاح.
2. حدد Places API من القائمة المنسدلة تحديد واجهات برمجة التطبيقات. إذا لم تكن واجهة برمجة تطبيقات الأماكن مُدرجة، عليك enable.
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="places-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

يمكنك الاطّلاع على مزيد من المعلومات عن Google Cloud SDK وتثبيت Cloud SDK والأوامر التالية:

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

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

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