الحصول على معرّف عميل 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 بـ your_keystore_name ومسار ملف تخزين المفاتيح واسمه، بما في ذلك .keystore الإضافة. سيُطلب منك إدخال كلمة مرور ملف تخزين المفاتيح. بَعْدَ ذَلِكْ يعرض keytool جميع الأسماء المستعارة في ملف تخزين المفاتيح.

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

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

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

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com