الحصول على معرّف عميل 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 Console والحصول على معرّف عميل OAuth 2.0.

  1. انتقِل إلى Google API Console.
  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