Mendapatkan Client ID OAuth 2.0

Ringkasan

Agar dapat menggunakan Google Fit untuk Android, Anda memerlukan client ID OAuth 2.0 untuk aplikasi Android.

Semua aplikasi Android ditandatangani dengan sertifikat digital yang Anda miliki kunci pribadinya. Lihat panduan Android untuk menandatangani aplikasi untuk mendapatkan informasi selengkapnya tentang sertifikat digital.

Client ID Android OAuth ditautkan ke pasangan sertifikat/paket tertentu. Anda hanya memerlukan satu ID untuk setiap sertifikat, berapa pun jumlah pengguna yang Anda miliki untuk aplikasi.

Mendapatkan ID untuk aplikasi memerlukan beberapa langkah. Langkah-langkah ini diuraikan di bawah.

  1. Temukan informasi sertifikat aplikasi Anda.
  2. Membuat atau mengubah project di Konsol API Google.
  3. Minta client ID OAuth 2.0.

Menemukan informasi sertifikat aplikasi

Kunci API didasarkan pada bentuk singkat sertifikat digital aplikasi Anda, yang dikenal sebagai sidik jari SHA-1. Agar dapat menampilkan sidik jari SHA-1 untuk sertifikat Anda, pastikan terlebih dahulu bahwa Anda menggunakan sertifikat yang tepat. Anda mungkin memiliki dua sertifikat:

  • Sertifikat debug: Android SDK Tools membuat sertifikat ini secara otomatis saat Anda membuat build debug. Hanya gunakan sertifikat ini bersama aplikasi yang sedang Anda uji. Jangan mencoba memublikasikan aplikasi yang ditandatangani dengan sertifikat debug. Sertifikat debug dijelaskan secara lebih mendetail dalam Penandatanganan dalam Mode Debug dalam Dokumentasi Developer Android.
  • Sertifikat rilis: Android SDK Tools membuat sertifikat ini saat Anda membuat build rilis. Anda juga dapat membuat sertifikat ini menggunakan program keytool. Gunakan sertifikat ini jika Anda siap merilis aplikasi Anda ke publik.

Ikuti langkah-langkah di bawah untuk menampilkan sidik jari SHA-1 sertifikat menggunakan program keytool dengan parameter -v. Untuk mendapatkan informasi lebih lanjut tentang Keytool, lihat dokumentasi Oracle.

Sertifikat debug

Menampilkan sidik jari sertifikat debug

  1. Temukan file keystore debug Anda. Nama file-nya adalah debug.keystore, dan dibuat saat pertama kali Anda membuat project. Secara default, file ini disimpan dalam direktori yang sama seperti file Android Virtual Device (AVD) Anda:

    • macOS dan Linux: ~/.android/
    • Windows Vista dan Windows 7: C:\Users\your_user_name\.android\
  2. Tampilkan daftar sidik jari SHA-1:

    • Untuk Linux atau macOS, buka jendela terminal dan masukkan berikut:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • Untuk Windows Vista dan Windows 7, jalankan:

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

Anda akan melihat output yang serupa dengan hal berikut:

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
Sertifikat rilis

Menampilkan sidik jari sertifikat rilis

  1. Temukan file keystore sertifikat rilis Anda. Tidak ada lokasi atau nama default untuk keystore rilis. Jika Anda tidak menetapkannya saat membuat aplikasi untuk rilis, build akan membiarkan .apk tidak ditandatangani, dan Anda harus menandatanganinya sebelum dapat memublikasikannya. Untuk sertifikat rilis, Anda juga memerlukan sandi dan alias sertifikat untuk keystore dan sertifikatnya. Anda dapat menampilkan daftar alias untuk semua kunci dalam keystore dengan memasukkan:

    keytool -list -keystore your_keystore_name

    Ganti your_keystore_name dengan jalur dan nama keystore yang sepenuhnya memenuhi syarat, termasuk ekstensi .keystore. Anda akan diminta memasukkan sandi keystore. Selanjutnya, keytool menampilkan semua alias dalam keystore.

  2. Masukkan hal berikut pada terminal atau command prompt:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    Ganti your_keystore_name dengan jalur dan nama keystore yang sepenuhnya memenuhi syarat, termasuk ekstensi .keystore. Ganti your_alias_name dengan alias yang ditetapkan ke sertifikat saat Anda membuatnya.

Anda akan melihat output yang serupa dengan hal berikut:

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

Baris yang diawali dengan SHA1 berisi sidik jari SHA-1 sertifikat. Sidik jari adalah rangkaian 20 angka heksadesimal dua digit yang dipisahkan dengan titik dua.

Meminta client ID OAuth 2.0 di Google API Console

Ikuti langkah-langkah berikut untuk membuat atau mengubah project untuk aplikasi Anda di Konsol API Google, mengaktifkan Fitness API, dan meminta client ID OAuth 2.0.

Jika Anda ingin dipandu melalui proses tersebut dan mengaktifkan Fitness API secara otomatis, klik

Mendapatkan Client ID

Atau, ikuti langkah-langkah berikut untuk mengaktifkan Fitness API di Konsol Google API dan mendapatkan client ID OAuth 2.0.

  1. Buka Konsol API Google.
  2. Pilih project, atau buat project baru. Gunakan project yang sama untuk versi Android dan REST aplikasi Anda.
  3. Klik Lanjutkan untuk mengaktifkan Fitness API.
  4. Klik Buka kredensial.
  5. Klik Kredensial baru, lalu pilih Client ID OAuth.
  6. Di bagian Jenis aplikasi, pilih Android.
  7. Dalam dialog yang dihasilkan, masukkan sidik jari SHA-1 aplikasi dan nama paket Anda. Contoh:

    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. Klik Create. Client ID dan rahasia Android OAuth 2.0 baru Anda muncul di daftar ID untuk project Anda. Client ID OAuth 2.0 adalah string karakter, seperti ini:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com