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

نظرة عامة

لاستخدام Google Fit لنظام التشغيل Android، يجب توفُّر معرِّف عميل OAuth 2.0 لتطبيقات Android.

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

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

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

  1. ابحث عن معلومات شهادة تطبيقك.
  2. إنشاء مشروع أو تعديله في وحدة التحكم في واجهة Google API
  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 بالاسم البديل الذي حدّدته للشهادة عند إنشائها.

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

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 API

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

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

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

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

  1. انتقِل إلى وحدة التحكم في واجهة Google API.
  2. اختَر مشروعًا أو أنشِئ مشروعًا جديدًا. استخدِم المشروع نفسه لإصداري Android وREST من تطبيقك.
  3. انقر على متابعة لتفعيل واجهة برمجة تطبيقات Fitness.
  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 الجديد في قائمة المعرّفات لمشروعك. ومعرِّف عميل OAuth 2.0 هو سلسلة من الأحرف، على النحو التالي:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com