دریافت شناسه کارخواه OAuth 2.0

نمای کلی

برای استفاده از Google Fit برای Android، به شناسه کارخواه OAuth 2.0 برای برنامه‌های Android نیاز دارید.

همه برنامه‌های Android با گواهی دیجیتالی امضا شده‌اند که شما کلید خصوصی آن را دارید. برای اطلاعات بیشتر درباره گواهی‌های دیجیتال، به راهنمای Android برای امضای برنامه‌ها مراجعه کنید.

شناسه‌های کارخواه OAuth Android به جفت‌های گواهی/بسته خاصی پیوند داده شده‌اند. برای هر گواهینامه فقط به یک شناسه نیاز دارید، مهم نیست چند کاربر برای برنامه دارید.

دریافت شناسه برای برنامه شما نیازمند چند مرحله است. این مراحل در زیر خلاصه شده است.

  1. اطلاعات گواهی برنامه‌تان را پیدا کنید.
  2. پروژه‌ای را در «کنسول Google API» ایجاد یا اصلاح کنید.
  3. شناسه کارخواه OAuth 2.0 درخواست کنید.

پیدا کردن اطلاعات گواهینامه برنامه

کلید API براساس شکل کوتاهی از گواهینامه دیجیتال برنامه شما است که به‌عنوان اثر انگشت SHA-1 آن شناخته می‌شود. برای نمایش اثر انگشت SHA-1 برای گواهینامه‌تان، ابتدا مطمئن شوید که از گواهینامه درست استفاده می‌کنید. ممکن است دو گواهینامه داشته باشید:

  • گواهینامه اشکال‌زدایی: ابزارهای «کیت توسعه نرم‌افزار Android» این گواهینامه را به‌طور خودکار هنگام ساختن اشکال‌زدایی تولید می‌کنند. فقط از این گواهینامه با برنامه‌هایی که درحال آزمایش آن‌ها هستید استفاده کنید. برنامه‌ای را که با گواهینامه اشکال‌زدایی امضا شده است منتشر نکنید. گواهینامه اشکال‌زدایی در امضا کردن در حالت اشکال‌زدایی در «اسناد توسعه‌دهنده Android» با جزئیات بیشتری توضیح داده شده است.
  • گواهینامه انتشار: ابزارهای «کیت توسعه نرم‌افزار 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 بدون امضا باقی می‌ماند و باید آن را قبل‌از انتشار امضا کنید. برای گواهینامه انتشار، به نام مستعار گواهینامه و گذرواژه‌های انبار کلید و گواهینامه نیز نیاز دارید. می‌توانید نام‌های مستعار همه کلیدهای موجود در keystore را با وارد کردن دستور زیر فهرست کنید:

    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، ازجمله افزونه .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 گواهینامه است. اثر انگشت دنباله‌ای از ۲۰ عدد شانزده‌شانزدهی دورقمی است که با دونقطه از هم جدا شده‌اند.

درخواست شناسه کارخواه OAuth 2.0 در «کنسول Google API»

برای ایجاد یا اصلاح پروژه برنامه‌تان در 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. روی ایجاد کردن کلیک کنید. «شناسه کارخواه» و رمز OAuth 2.0 جدید Android شما در فهرست شناسه‌های پروژه‌تان نشان داده می‌شود. «شناسه کارخواه OAuth 2.0» رشته‌ای از نویسه‌ها است، چیزی شبیه این:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com