Uzyskiwanie identyfikatora klienta OAuth 2.0

Przegląd

Aby korzystać z Google Fit na Androida, potrzebujesz identyfikatora klienta OAuth 2.0 do aplikacji na Androida.

Wszystkie aplikacje na Androida są podpisane certyfikatem cyfrowym, w przypadku którego masz klucz prywatny. Więcej informacji o certyfikatach cyfrowych znajdziesz w przewodniku po podpisywaniu aplikacji na Androida.

Identyfikatory klienta Androida na Androida są połączone z określonymi parami certyfikatów i pakietów. Niezależnie od liczby użytkowników aplikacji potrzebujesz tylko 1 identyfikatora dla każdego certyfikatu.

Aby uzyskać identyfikator, musisz wykonać kilka czynności. Poniżej omawiamy te kroki.

  1. Znajdź informacje o certyfikacie aplikacji.
  2. Utwórz lub zmodyfikuj projekt w Konsoli interfejsów API Google.
  3. Poproś o identyfikator klienta OAuth 2.0.

Znajdowanie informacji o certyfikacie aplikacji

Klucz interfejsu API jest oparty na krótkim formacie cyfrowego certyfikatu aplikacji nazywanym odciskiem cyfrowym SHA-1. Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu, najpierw upewnij się, że używasz odpowiedniego certyfikatu. Możesz mieć 2 certyfikaty:

  • Certyfikat debugowania: narzędzia Android SDK SDK automatycznie generują ten certyfikat podczas tworzenia kompilacji na potrzeby debugowania. Używaj tego certyfikatu tylko w testowanych aplikacjach. Nie próbuj publikować aplikacji podpisanej certyfikatem debugowania. Certyfikat debugowania został opisany w sekcji Podpisywanie w trybie debugowania w dokumentacji Androida dla deweloperów.
  • Certyfikat wydania: narzędzia pakietu SDK na Androida generują ten certyfikat podczas tworzenia wersji. Certyfikat możesz też wygenerować w programie keytool. Użyj tego certyfikatu, gdy aplikacja będzie gotowa do udostępnienia użytkownikom na całym świecie.

Wykonaj poniższe czynności, aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu za pomocą programu keytool z parametrem -v. Więcej informacji o Keytool znajdziesz w dokumentacji Oracle.

Certyfikat debugowania

Wyświetlam odcisk cyfrowy certyfikatu debugowania

  1. Znajdź plik magazynu kluczy debugowania. Nazwa pliku to debug.keystore. Jest on tworzony po raz pierwszy podczas tworzenia projektu. Domyślnie znajduje się on w tym samym katalogu co pliki urządzeń wirtualnych (AVD) Androida:

    • macOS i Linux: ~/.android/
    • Windows Vista i Windows 7: C:\Users\your_user_name\.android\
  2. Wyświetl listę odcisków cyfrowych SHA-1:

    • W systemie Linux lub macOS otwórz okno terminala i wpisz te informacje:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • W systemach Windows Vista i Windows 7 uruchom:

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

Dane wyjściowe powinny wyglądać mniej więcej tak:

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
Certyfikat wydania

Wyświetlam odcisk cyfrowy certyfikatu wersji

  1. Znajdź plik magazynu kluczy wersji certyfikatu. Nie ma domyślnej lokalizacji lub nazwy magazynu kluczy wersji. Jeśli nie określisz identyfikatora podczas tworzenia aplikacji, wersja .apk pozostanie niepodpisana i będzie trzeba ją podpisać, zanim będzie można opublikować aplikację. Jako certyfikat możesz też użyć aliasu certyfikatu oraz haseł do magazynu kluczy i certyfikatu. Możesz wyświetlić listę wszystkich kluczy w magazynie kluczy, wpisując:

    keytool -list -keystore your_keystore_name

    Zastąp your_keystore_name w pełni kwalifikowaną ścieżką i nazwą magazynu kluczy, razem z rozszerzeniem .keystore. Pojawi się prośba o podanie hasła do magazynu kluczy. Następnie keytool wyświetli wszystkie aliasy w magazynie kluczy.

  2. Wpisz w terminalu lub w wierszu poleceń:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    Zastąp your_keystore_name w pełni kwalifikowaną ścieżką i nazwą magazynu kluczy, razem z rozszerzeniem .keystore. Zastąp your_alias_name aliasem przypisanym do certyfikatu podczas jego tworzenia.

Dane wyjściowe powinny wyglądać mniej więcej tak:

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

Wiersz zaczynający się od SHA1 zawiera odcisk cyfrowy certyfikatu SHA-1. Odcisk cyfrowy to sekwencja 20-cyfrowych liczb szesnastkowych oddzielonych dwukropkami.

Żądanie identyfikatora klienta OAuth 2.0 w konsoli interfejsu Google API

Aby utworzyć lub zmodyfikować projekt aplikacji w Konsoli interfejsów API Google, włączyć interfejs Fitness API i poprosić o identyfikator klienta OAuth 2.0.

Jeśli chcesz przeprowadzić tę procedurę i automatycznie aktywować interfejs Fitness API, kliknij

Pobierz identyfikator klienta

Aby włączyć interfejs Fitness API w konsoli Google API i uzyskać identyfikator klienta OAuth 2.0, możesz też wykonać te czynności.

  1. Otwórz Konsolę interfejsów API Google.
  2. Wybierz projekt lub utwórz nowy. Użyj tego samego projektu dla wersji aplikacji na Androida i REST.
  3. Kliknij Dalej, aby włączyć Fitness API.
  4. Kliknij Przejdź do danych logowania.
  5. Kliknij kolejno Nowe dane logowania i Identyfikator klienta OAuth.
  6. W sekcji Typ aplikacji wybierz Android.
  7. W wyświetlonym oknie wpisz odcisk cyfrowy SHA-1 aplikacji i nazwę pakietu. Na przykład:

    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. Kliknij Utwórz. Nowy identyfikator klienta OAuth 2.0 i tajny klucz pojawią się na liście identyfikatorów Twojego projektu. Identyfikator klienta OAuth 2.0 to ciąg znaków podobny do tego:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com