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

نظرة عامة

لاستخدام Google Fit على Android، يجب أن يتوفّر لديك معرّف عميل OAuth 2.0 لتطبيقات Android.

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

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

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

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

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

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

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

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

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com