قبل البدء
قبل البدء في استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android، ستحتاج إلى مشروع يتضمّن حساب فوترة وحزمة تطوير برامج "خرائط Google" للتطبيقات المتوافقة مع Android. للحصول على مزيد من المعلومات، يُرجى الاطِّلاع على الإعداد في Cloud Console.
إنشاء مفاتيح واجهة برمجة التطبيقات
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.
لإنشاء مفتاح لواجهة برمجة التطبيقات:
وحدة التحكّم
-
انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.
-
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
يعرض مربّع الحوار مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا. -
انقر على إغلاق.
يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
(تذكَّر حظر واجهة برمجة التطبيقات قبل استخدامها في الإنتاج).
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
اطّلِع على مزيد من المعلومات عن حزمة تطوير برامج Google Cloud SDK و تثبيت حزمة تطوير برامج Google Cloud والطلبات التالية:
فرض قيود على مفاتيح واجهة برمجة التطبيقات
وتنصحك 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
- قيود واجهة برمجة التطبيقات:
- انقر على تقييد المفتاح.
- اختَر Maps SDK لنظام التشغيل Android من القائمة المنسدلة Select APIs. إذا لم تكن حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لأجهزة Android مُدرَجة، عليك تفعيلها.
- لإنهاء التغييرات، انقر على حفظ.
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-android-backend.googleapis.com" --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
اطّلِع على مزيد من المعلومات عن حزمة تطوير برامج Google Cloud SDK و تثبيت حزمة تطوير برامج Google Cloud والطلبات التالية:
الخطوات التالية
بعد أن حصلت على مفتاح واجهة برمجة التطبيقات، عليك إنشاء مشروع وضبطه على النحو الموضّح في إعداد مشروع على "استوديو Android".