OAuth 2.0 İstemci Kimliği alın

Genel Bakış

Android için Google Fit'i kullanmak istiyorsanız Android uygulamaları için bir OAuth 2.0 istemci kimliğiniz olmalıdır.

Tüm Android uygulamaları, özel anahtarına sahip olduğunuz bir dijital sertifikayla imzalanır. Dijital sertifikalar hakkında daha fazla bilgi için Uygulamalarınızı imzalamayla ilgili Android kılavuzuna bakın.

Android OAuth istemci kimlikleri, belirli sertifika/paket çiftlerine bağlıdır. Uygulamanın kaç kullanıcısı olursa olsun her sertifika için yalnızca bir kimliğe ihtiyacınız vardır.

Uygulamanız için kimlik almak birkaç adım gerektirir. Bu adımlar aşağıda açıklanmıştır.

  1. Uygulamanızın sertifika bilgilerini bulma
  2. Google API Konsolu'nda proje oluşturun veya mevcut bir projeyi değiştirin.
  3. OAuth 2.0 istemci kimliği isteyin.

Uygulamanızın sertifika bilgilerini bulma

API anahtarı, uygulamanızın dijital sertifikasının SHA-1 parmak izi olarak bilinen kısa bir biçimine dayanır. Sertifikanızın SHA-1 parmak izini görüntülemek için öncelikle doğru sertifikayı kullandığınızdan emin olun. İki sertifikanız olabilir:

  • Hata ayıklama sertifikası: Android SDK araçları, hata ayıklama derlemesi yaptığınızda bu sertifikayı otomatik olarak oluşturur. Bu sertifikayı yalnızca test ettiğiniz uygulamalarda kullanın. Hata ayıklama sertifikasıyla imzalanmış bir uygulamayı yayınlamaya çalışmayın. Hata ayıklama sertifikası, Android Geliştirici Belgeleri'ndeki Hata Ayıklama Modunda İmzalama bölümünde daha ayrıntılı olarak açıklanmaktadır.
  • Yayın sertifikası: Android SDK araçları, yayınlanan derleme oluşturduğunuzda bu sertifikayı oluşturur. Bu sertifikayı keytool programını kullanarak da oluşturabilirsiniz. Uygulamanızı tüm dünyada yayınlamaya hazır olduğunuzda bu sertifikayı kullanın.

-v parametresiyle keytool programını kullanarak bir sertifikanın SHA-1 parmak izini görüntülemek için aşağıdaki adımları uygulayın. Keytool hakkında daha fazla bilgi için Oracle belgelerine bakın.

Hata ayıklama sertifikası

Hata ayıklama sertifikası parmak izini görüntüleme

  1. Hata ayıklama anahtar deposu dosyanızı bulun. Dosya adı debug.keystore şeklindedir ve projenizi ilk kez derlediğinizde oluşturulur. Varsayılan olarak, Android Sanal Cihazı (AVD) dosyalarınızla aynı dizinde depolanır:

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

  2. SHA-1 parmak izini listeleme:

    • Linux veya macOS için bir terminal penceresi açın ve aşağıdakileri girin:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • Windows Vista ve Windows 7 için şu komutu çalıştırın:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Şuna benzer bir çıkış alırsınız:

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
Sertifikayı yayınlama

Sürüm sertifikası parmak izi gösteriliyor

  1. Sürüm sertifikası anahtar deposu dosyanızı bulun. Sürüm anahtar deposu için varsayılan bir konum veya ad yoktur. Uygulamanızı yayınlamak için derlerken bir anahtar belirtmezseniz derleme, .apk dosyanızı imzasız bırakır ve yayınlamadan önce imzalamanız gerekir. Sürüm sertifikası için sertifikanın takma adına, anahtar deposunun ve sertifikanın şifrelerine de ihtiyacınız vardır. Aşağıdaki komutu girerek bir anahtar deposundaki tüm anahtarların takma adlarını listeleyebilirsiniz:

    keytool -list -keystore your_keystore_name

    your_keystore_name ifadesini, .keystore uzantısı da dahil olmak üzere anahtar deposunun tam yolu ve adıyla değiştirin. Anahtar deposunun şifresi istenir. Ardından keytool, anahtar deposundaki tüm takma adları gösterir.

  2. Terminal veya komut istemine aşağıdakileri girin:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    your_keystore_name ifadesini, .keystore uzantısı da dahil olmak üzere anahtar deposunun tam yolu ve adıyla değiştirin. your_alias_name ifadesini, sertifikayı oluştururken atadığınız takma adla değiştirin.

Şuna benzer bir çıkış alırsınız:

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 ile başlayan satır, sertifikanın SHA-1 parmak izini içerir. Parmak izi, iki nokta üst üste ile ayrılmış 20 adet iki basamaklı onaltılık sayı dizisidir.

Google API Konsolu'nda OAuth 2.0 istemci kimliği isteyin.

Google API Konsolu'nda uygulamanız için proje oluşturmak veya mevcut bir projeyi değiştirmek, Fitness API'yi etkinleştirmek ve OAuth 2.0 istemci kimliği istemek için aşağıdaki adımları uygulayın.

Süreç boyunca rehberlik almak ve Fitness API'yi otomatik olarak etkinleştirmek istiyorsanız

İstemci kimliği alma

Alternatif olarak, Google API Konsolu'nda Fitness API'yi etkinleştirmek ve OAuth 2.0 istemci kimliği almak için aşağıdaki adımları uygulayın.

  1. Google API Konsolu'na gidin.
  2. Bir proje seçin veya yeni bir proje oluşturun. Uygulamanızın Android ve REST sürümleri için aynı projeyi kullanın.
  3. Fitness API'yi etkinleştirmek için Devam'ı tıklayın.
  4. Kimlik bilgilerine git'i tıklayın.
  5. Yeni kimlik bilgileri'ni tıklayın, ardından OAuth istemci kimliği'ni seçin.
  6. Uygulama türü bölümünde Android'i seçin.

  7. Açılan iletişim kutusunda uygulamanızın SHA-1 parmak izini ve paket adını girin. Örneğin:

    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. Oluştur'u tıklayın. Yeni Android OAuth 2.0 istemci kimliğiniz ve gizli anahtarınız, projenizin kimlik listesinde görünür. OAuth 2.0 istemci kimliği, şuna benzer bir karakter dizesidir:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com