الحصول على معرّف عميل OAuth 2.0

نظرة عامة

لاستخدام تطبيق Google Fit على Android، تحتاج إلى معرِّف عميل OAuth 2.0 لتطبيقات Android.

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

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

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

  1. ابحث عن معلومات شهادة تطبيقك.
  2. أنشئ مشروعًا أو عدِّله في "وحدة تحكّم واجهة برمجة تطبيقات Google".
  3. اطلب الحصول على معرِّف عميل OAuth 2.0.

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

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

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

اتّبِع الخطوات التالية لعرض بصمة SHA-1 للشهادة باستخدام برنامج keytool مع المَعلمة -v. لمزيد من المعلومات حول Keytool، يُرجى الاطّلاع على مستندات Oracle.

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

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

  1. حدِّد موقع ملف تخزين مفاتيح تصحيح الأخطاء. اسم الملف هو debug.keystore، ويتم إنشاؤه في المرة الأولى التي تُنشئ فيها مشروعك. يتم تخزينه تلقائيًا في الدليل نفسه الذي تتوفّر فيه ملفات "جهاز Android العامودي (AVD)":

    • macOS وLinux: ~/.android/
    • Windows Vista وWindows 7: C:\Users\your_user_name\.android\

  2. إدراج بصمة SHA-1:

    • بالنسبة إلى نظام التشغيل Linux أو macOS، افتح نافذة محطة طرفية وأدخِل ما يلي:

      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
شهادة الإصدار

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

  1. حدِّد مكان ملف تخزين مفاتيح شهادة الإصدار. لا يتوفّر موقع أو اسم تلقائيان لمستودع مفاتيح الإصدار. إذا لم تحدِّد توقيعًا عند إنشاء تطبيقك لطرحه، سيبقى .apk بدون توقيع، وسيكون عليك توقيعه قبل أن تتمكّن من نشره. بالنسبة إلى شهادة الإصدار، ستحتاج أيضًا إلى اسم البديل للشهادة وكلمات مرور ملف تخزين المفاتيح والشهادة. يمكنك إدراج الأسماء البديلة لجميع المفاتيح في مخزن مفاتيح من خلال إدخال:

    keytool -list -keystore your_keystore_name

    استبدِل your_keystore_name بالمسار المُحدَّد بالكامل واسم ملف تخزين المفاتيح، بما في ذلك اللاحقة .keystore. سيُطلب منك إدخال كلمة مرور ملف تخزين المفاتيح. بعد ذلك، يعرض keytool جميع الأسماء البديلة في ملف تخزين المفاتيح.

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

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    استبدِل your_keystore_name بالمسار المُحدَّد بالكامل واسم ملف تخزين المفاتيح، بما في ذلك اللاحقة .keystore. استبدِل your_alias_name بالاسم المستعار الذي assigned قدّمته للشهادة عند إنشائها.

من المفترض أن يظهر لك ناتج مشابه لما يلي:

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 رقمًا سداسيًا عشريًا يتكوّن من رقمَين مفصولَين بنقطتَين.

طلب معرّف عميل OAuth 2.0 في "وحدة تحكّم واجهة برمجة تطبيقات Google"

اتّبِع الخطوات التالية لإنشاء مشروع لتطبيقك أو تعديله في وحدة تحكّم واجهة برمجة تطبيقات Google، وتفعيل Fitness API، وطلب رقم تعريف عميل OAuth 2.0.

إذا أردت الحصول على إرشادات خلال العملية وتفعيل واجهة برمجة التطبيقات Fitness API تلقائيًا، انقر على

الحصول على معرّف عميل

بدلاً من ذلك، يمكنك اتّباع الخطوات التالية لتفعيل واجهة برمجة التطبيقات Fitness API في وحدة تحكّم واجهة برمجة تطبيقات Google والحصول على معرّف عميل OAuth 2.0.

  1. انتقِل إلى وحدة تحكّم واجهة برمجة التطبيقات Google API.
  2. اختَر مشروعًا أو أنشئ مشروعًا جديدًا. استخدِم المشروع نفسه لإصدارَي تطبيقك المتوافقَين مع Android وREST.
  3. انقر على متابعة لتفعيل Fitness API.
  4. انقر على الانتقال إلى بيانات الاعتماد.
  5. انقر على بيانات اعتماد جديدة، ثم اختَر معرِّف عميل OAuth.
  6. ضمن نوع التطبيق، اختَر Android.

  7. في مربّع الحوار الناتج، أدخِل الملف المرجعي 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.fit-example

  8. انقر على إنشاء. يظهر معرّف عميل وسر OAuth 2.0 الجديدان لنظام التشغيل Android في قائمة أرقام تعريف مشروعك. معرّف عميل OAuth 2.0 هو سلسلة من الأحرف، على النحو التالي:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com