دریافت شناسه کارخواه 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 برای گواهینامه‌تان، ابتدا مطمئن شوید که از گواهینامه درست استفاده می‌کنید. ممکن است دو گواهینامه داشته باشید:

  • گواهینامه اشکال‌زدایی: ابزارهای کیت توسعه نرم‌افزار Android این گواهینامه را به‌طور خودکار هنگام ساخت اشکال‌زدایی تولید می‌کنند. از این گواهی فقط برای برنامه‌هایی که درحال آزمایش آن‌ها هستید استفاده کنید. برنامه‌ای را که با گواهینامه اشکال‌زدایی امضا شده است منتشر نکنید. گواهینامه اشکال‌زدایی با جزئیات بیشتر در امضا کردن در حالت اشکال‌زدایی در «اسناد توسعه‌دهنده Android» شرح داده شده است.
  • گواهی انتشار: ابزارهای کیت توسعه نرم‌افزار Android این گواهی را هنگام ساخت نسخه پخش تولید می‌کنند. همچنین می‌توانید این گواهی را بااستفاده از برنامه keytool تولید کنید. وقتی آماده انتشار برنامه‌تان در جهان هستید، از این گواهی استفاده کنید.

مراحل زیر را برای نمایش اثر انگشت SHA-1 گواهینامه بااستفاده از برنامه keytool با پارامتر -v دنبال کنید. برای اطلاعات بیشتر درباره Keytool، به اسناد Oracle مراجعه کنید.

گواهینامه اشکال‌زدایی

درحال نمایش اثر انگشت گواهینامه اشکال‌زدایی

  1. فایل keystore اشکال‌زدایی را پیدا کنید. نام فایل debug.keystore است و اولین‌باری که پروژه‌تان را می‌سازید ایجاد می‌شود. به‌طور پیش‌فرض، این فایل در همان دایرکتوری فایل‌های «دستگاه مجازی Android» (AVD) شما ذخیره می‌شود:

    • macOS و Linux: ~/.android/
    • Windows Vista و Windows 7: C:\Users\your_user_name\.android\

  2. اثر انگشت اس‌اچ‌اِی-۱ را فهرست کنید:

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

    keytool -list -keystore your_keystore_name

    your_keystore_name را با مسیر و نام کاملاً واجدشرایط keystore، ازجمله افزونه .keystore، جایگزین کنید. گذرواژه keystore از شما خواسته می‌شود. سپس keytool همه نام‌های مستعار را در keystore نمایش می‌دهد.

  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