قبل البدء
قبل بدء استخدام حزمة تطوير برامج الأماكن لنظام التشغيل Android، تحتاج إلى مشروع به حساب فوترة وتفعيل حزمة تطوير برامج الأماكن لنظام التشغيل Android. لمزيد من المعلومات، يُرجى الاطّلاع على الإعداد في Cloud Console.
إنشاء مفاتيح واجهة برمجة التطبيقات
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.
لإنشاء مفتاح واجهة برمجة التطبيقات:
وحدة التحكم
-
انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.
-
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
يعرض مربّع الحوار تم إنشاء مفتاح واجهة برمجة التطبيقات مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا. -
انقر على إغلاق.
يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
(احرص على تقييد مفتاح واجهة برمجة التطبيقات قبل استخدامه في مرحلة الإنتاج.)
Cloud SDK
gcloud alpha services api-keys create \
--project "PROJECT" \
--display-name "DISPLAY_NAME"
يمكنك الاطّلاع على مزيد من المعلومات عن حزمة تطوير البرامج (SDK) في Google Cloud، وتثبيت حزمة تطوير البرامج (SDK) في السحابة الإلكترونية والأوامر التالية:
تقييد مفاتيح واجهة برمجة التطبيقات
تنصح Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات عن طريق حصر استخدامها على واجهات برمجة التطبيقات المطلوبة لتطبيقك فقط. يؤدي تقييد مفاتيح واجهة برمجة التطبيقات إلى إضافة أمان إلى تطبيقك عن طريق حمايته من الطلبات غير المضمونة. لمزيد من المعلومات، يُرجى الاطِّلاع على أفضل ممارسات أمان واجهة برمجة التطبيقات.
عند تقييد مفتاح واجهة برمجة التطبيقات، يجب تقديم الملف المرجعي لشهادة SHA-1 لمفتاح التوقيع الذي تم استخدامه لتوقيع التطبيق. هناك نوعان من الشهادات:
- شهادة تصحيح الأخطاء: لا تستخدم هذا النوع من الشهادات إلا مع التطبيقات التي تختبرها والرموز غير الإنتاجية الأخرى. لا تحاول نشر تطبيق موقَّع باستخدام شهادة تصحيح الأخطاء. تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند تشغيل إصدار تصحيح الأخطاء.
- شهادة الإصدار: استخدم هذه الشهادة عندما تكون مستعدًا لإصدار تطبيقك من متجر التطبيقات. تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة عند تشغيل إصدار إصدار.
لمزيد من المعلومات حول توقيع تطبيقات Android والشهادات، يمكنك الاطّلاع على دليل توقيع التطبيق.
للحصول على تعليمات حول كيفية العثور على الملف المرجعي لشهادة التوقيع، يُرجى الاطّلاع على المراجع أدناه:
- إذا كنت تستخدم ميزة توقيع التطبيق من Play، يُرجى الاطّلاع على العمل مع مزوّدي واجهة برمجة التطبيقات.
- إذا كنت تدير مفتاح التوقيع الخاص بك، يمكنك الاطّلاع على التوقيع الذاتي لطلبك أو يمكنك الاطّلاع على التعليمات المتعلّقة ببيئة الإصدار.
لتقييد مفتاح واجهة برمجة التطبيقات:
وحدة التحكم
-
انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.
- اختَر مفتاح واجهة برمجة التطبيقات الذي تريد فرض قيود عليه. ستظهر صفحة خصائص مفتاح واجهة برمجة التطبيقات.
- ضمن القيود الرئيسية، اضبط القيود التالية:
- قيود التطبيقات:
- اختَر تطبيقات Android.
- انقر على + إضافة اسم الحزمة وبصمة الإصبع.
- أدخل اسم الحزمة والملف المرجعي لشهادة SHA-1. على سبيل المثال:
com.example.android.mapexample
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
- قيود واجهة برمجة التطبيقات:
- انقر على تقييد المفتاح.
- اختر Places API من القائمة المنسدلة اختيار واجهات برمجة التطبيقات. إذا لم تكن واجهة برمجة تطبيقات الأماكن مدرَجة، عليك تفعيلها.
- لإنهاء التغييرات التي أجريتها، انقر على حفظ.
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-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
يمكنك الاطّلاع على مزيد من المعلومات عن حزمة تطوير البرامج (SDK) في Google Cloud، وتثبيت حزمة تطوير البرامج (SDK) في السحابة الإلكترونية والأوامر التالية:
الخطوات التالية
بعد أن أصبح لديك مفتاح واجهة برمجة التطبيقات، يمكنك إنشاء مشروع وضبطه كما هو موضّح في إعداد مشروع "استوديو Android".