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

نظرة عامة

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

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

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

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

  1. ابحث عن معلومات شهادة تطبيقك.
  2. إنشاء مشروع أو تعديله في Google Console 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 الافتراضية:

    • نظاما التشغيل 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 وتفعيل واجهة برمجة تطبيقات اللياقة البدنية وطلب معرِّف عميل OAuth 2.0.

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

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

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

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com