OAuth 2.0 İstemci Kimliği alın

Genel Bakış

Android için Google Fit'i kullanmak üzere Android uygulamaları için bir OAuth 2.0 istemci kimliğine ihtiyacınız vardır.

Tüm Android uygulamaları, özel anahtarını elinizde bulundurduğunuz bir dijital sertifikayla imzalanır. Dijital sertifikalar hakkında daha fazla bilgi için Android uygulamalarınızı imzalama kılavuzuna bakın.

Android OAuth istemci kimlikleri belirli sertifika/paket çiftleriyle bağlantılıdır. Uygulamanızın kaç kullanıcısı olursa olsun, her sertifika için yalnızca bir kimlik gerekir.

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

  1. Uygulamanızın sertifika bilgilerini bulun.
  2. Google API Konsolu'nda bir 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 kısa biçimine (SHA-1 parmak izi olarak bilinir) dayanır. Sertifikanızın SHA-1 parmak izini görüntülemek için önce 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ın derlemesi yaptığınızda 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 dijital 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 olup projenizi ilk kez oluşturduğunuzda 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 listeleyin:

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

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • Windows Vista ve Windows 7 için şunu ç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
Yayın sertifikası

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

  1. Yayın sertifikası anahtar deposu dosyanızı bulun. Yayın anahtar deposu için varsayılan bir konum veya ad yoktur. Uygulamanızı yayınlanmak üzere oluştururken belirtmezseniz derleme .apk imzalanmamış olarak kalır ve yayınlamadan önce imzalamanız gerekir. Yayın sertifikası için sertifikanın diğer adı ile anahtar deposu ve sertifika şifreleri de gerekir. Aşağıdaki komutu girerek anahtar deposundaki tüm anahtarların takma adlarını listeleyebilirsiniz:

    keytool -list -keystore your_keystore_name

    your_keystore_name yerine, .keystore uzantısı da dahil olmak üzere anahtar deposunun tam yolu ve adını girin. Keystore'un şifresini girmeniz istenir. Ardından keytool, anahtar deposundaki tüm takma adları gösterir.

  2. Terminalde veya komut isteminde aşağıdakileri girin:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    your_keystore_name yerine, .keystore uzantısı da dahil olmak üzere anahtar deposunun tam yolu ve adını girin. your_alias_name kısmını, 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ırda sertifikanın SHA-1 parmak izi bulunur. Parmak izi, iki nokta ile ayrılmış 20 adet iki basamaklı on altılı sayı dizisidir.

Google API Konsolu'nda OAuth 2.0 istemci kimliği isteğinde bulunma

Google API Konsolu'nda uygulamanız için bir proje oluşturmak veya 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 kutusuna 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 kimlikleri listesinde görünür. OAuth 2.0 istemci kimliği, aşağıdaki gibi bir karakter dizisidir:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com