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

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

إشعار بالإيقاف النهائي: تم إيقاف Awareness API نهائيًا.

لاستخدام Google Awareness API، يجب إضافة مفتاح Google API إلى تطبيقك. نوع مفتاح واجهة برمجة التطبيقات الذي تحتاجه هو مفتاح Android API.

يتم توقيع جميع تطبيقات Android باستخدام شهادة رقمية تحتفظ بمفتاحها الخاص. لمزيد من المعلومات حول الشهادات الرقمية، يُرجى الرجوع إلى دليل Android حول كيفية توقيع تطبيقك.

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

يجب اتّباع عدة خطوات للحصول على مفتاح لتطبيقك، وهي موضّحة بالتفصيل في هذا الدليل، ويمكن تلخيصها على النحو التالي:

الحصول على معلومات حول شهادة تطبيقك
سجِّل مشروعًا في Google Developers Console وأضِف User Context API كخدمة للمشروع.
اطلب مفتاحًا.
أضِف المفتاح إلى تطبيقك من خلال إضافة عنصر إلى بيان التطبيق.

العثور على معلومات شهادة تطبيقك

يستند مفتاح واجهة برمجة التطبيقات إلى نموذج قصير من الشهادة الرقمية لتطبيقك، يُعرف باسم الملف المرجعي لشهادة SHA-1. لعرض الملف المرجعي لشهادة SHA-1، تأكَّد أولاً من استخدام الشهادة الصحيحة. قد تظهر لك الشهادتان التاليتان للاختيار من بينهما:

شهادة تصحيح الأخطاء: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند إنشاء إصدار مخصص لتصحيح الأخطاء. لا تستخدِم هذه الشهادة إلا مع التطبيقات التي تختبرها. لا تحاول نشر تطبيق موقَّع بشهادة تصحيح الأخطاء. يتم شرح شهادة تصحيح الأخطاء بمزيد من التفصيل في قسم توقيع الإصدار المخصص لتصحيح الأخطاء في مستندات مطوّري برامج Android.
شهادة إصدار: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة عند إنشاء بنية الإصدار. يمكنك أيضًا إنشاء هذه الشهادة باستخدام برنامج keytool. استخدِم هذه الشهادة عندما تكون مستعدًا لإصدار تطبيقك للجميع.

لمزيد من المعلومات حول keytool، يُرجى الاطّلاع على مستندات Oracle.

شهادة تصحيح الأخطاء

عرض الملف المرجعي لشهادة تصحيح الأخطاء

استخدِم برنامج keytool مع مَعلمة -v لعرض الملف المرجعي لشهادة SHA-1. لإجراء ذلك، يُرجى إكمال الخطوات التالية:

حدِّد مكان ملف تخزين مفاتيح تصحيح الأخطاء. اسم الملف هو debug.keystore، ويتم إنشاؤه في المرة الأولى التي تنشئ فيها مشروعك. يتم تخزينها تلقائيًا في الدليل نفسه الذي يتضمّن ملفات جهاز Android الافتراضي (AVD):
- نظاما التشغيل OS X وLinux: ~/.android/
- نظاما التشغيل Windows Vista وWindows 7: C:\Users\your_user_name\.android\
أدرِج الملف المرجعي لشهادة SHA-1:
- بالنسبة إلى نظام التشغيل Linux أو OS X، افتح نافذة المحطة الطرفية وأدخِل ما يلي:
```
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
```
- بالنسبة إلى نظامَي التشغيل Windows Vista وWindows 7، شغِّل ما يلي:
```
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
```

ينبغي أن تظهر مُخرجات مشابهة لما يلي:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

شهادة الإصدار

عرض الملف المرجعي لشهادة الإصدار

استخدِم برنامج keytool مع مَعلمة -v لعرض الملف المرجعي لشهادة SHA-1. لإجراء ذلك، يُرجى إكمال الخطوات التالية:

ابحث عن ملف تخزين مفاتيح شهادة الإصدار. لا يوجد موقع جغرافي أو اسم تلقائي لمخزن مفاتيح الإصدار. إذا لم تحدّد مفتاحًا عند إنشاء تطبيقك للإصدار، سيترك الإصدار .apk بدون توقيع وعليك توقيعه قبل أن تتمكّن من نشره. بالنسبة إلى شهادة الإصدار، ستحتاج أيضًا إلى الاسم المستعار للشهادة وكلمات المرور الخاصة بملف تخزين المفاتيح والشهادة.
أدخِل ما يلي لعرض الأسماء البديلة لجميع المفاتيح في ملف تخزين المفاتيح:
```
keytool -list -keystore your_keystore_name
      
```
استبدِل your_keystore_name بالمسار المؤهَّل بالكامل واسم مخزن المفاتيح. أدرِج الإضافة .keystore. أدخِل كلمة مرور ملف تخزين المفاتيح عندما يُطلب منك ذلك. بعد ذلك، يعرض keytool جميع الأسماء المستعارة في مخزن المفاتيح.

أدخِل ما يلي في الوحدة الطرفية أو موجّه الأوامر:

      keytool -list -v -keystore your_keystore_name -alias your_alias_name

استبدِل your_keystore_name بالمسار المؤهَّل بالكامل واسم مخزن المفاتيح. أدرِج الإضافة .keystore.
استبدِل your_alias_name بالاسم المستعار الذي عيّنته للشهادة عند إنشائها.

ينبغي أن تظهر مُخرجات مشابهة لما يلي:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

يحتوي السطر الذي يبدأ بـ SHA1 على الملف المرجعي لشهادة SHA-1. البصمة هي تسلسل من 20 رقمًا سداسيًا عشريًا مكوّنًا من رقمَين تفصل بينها نقطتان.

تنبيه: لحماية ملف تخزين المفاتيح والمفتاح، لا تُدخِل الوسيطتَين storepass أو keypass في سطر الأوامر إلا إذا كنت واثقًا من أمان جهاز الكمبيوتر. على سبيل المثال، على جهاز كمبيوتر عام، يمكن لشخص ما الاطّلاع على سجلّ نافذة المحطة الطرفية أو قائمة العمليات الجارية، والحصول على كلمة المرور، ثم الحصول على إذن الكتابة في شهادة التوقيع. سيسمح ذلك لهذا الشخص بتعديل تطبيقك أو استبداله بتطبيقه الخاص.

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

لبدء استخدام Google Awareness API، انقر على الزر الحصول على مفتاح. وتتضمّن هذه الأداة رابطًا يؤدي إلى Google Developers Console، والتي ترشدك خلال العملية وتفعّل واجهة Awareness API تلقائيًا.

الحصول على مفتاح

بدلاً من ذلك، اتّبِع الخطوات التالية للحصول على مفتاح واجهة برمجة التطبيقات:

انتقِل إلى Google Developers Console.
اختَر مشروعًا أو أنشِئ مشروعًا جديدًا.
انقر على متابعة لتفعيل Awareness API.
في صفحة "بيانات الاعتماد" (Credentials)، أنشِئ مفتاح Android واضبط بيانات اعتماد واجهة برمجة التطبيقات.
ملاحظة: إذا كان لديك مفتاح Android حالي، يمكنك استخدامه.
في مربّع الحوار "إنشاء مفتاح"، عليك حصر استخدامك على تطبيقات Android. لإجراء ذلك، أدخِل الملف المرجعي لشهادة SHA-1 واسم الحزمة لتطبيقك، كما في المثال التالي:
```
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.awareness-example
```
انقر على إنشاء. يظهر مفتاح واجهة برمجة التطبيقات الجديد لنظام التشغيل Android في قائمة مفاتيح واجهة برمجة التطبيقات لمشروعك. مفتاح واجهة برمجة التطبيقات هو سلسلة من الأحرف، مثل ما يلي:
```
AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
```

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

تفعيل واجهات برمجة تطبيقات إضافية

تتيح لك واجهة Awareness API الوصول إلى أنواع متعددة من البيانات السياقية، مثل أجهزة الإرشاد. لاستخدام هذه الأنواع، عليك تفعيل واجهات برمجة التطبيقات المقابلة في Google Developers Console.

الخدمة	طرق Awareness API	واجهة برمجة التطبيقات المطلوب تفعيلها
Beacons	‫`SnapshotApi.getBeaconState()`، `FenceApi.BeaconFence`	Nearby Messages API