Rejestracja i klucze interfejsu API

Aby korzystać z interfejsu Google Know API, musisz dodać do aplikacji klucz interfejsu API Google. Typ klucza interfejsu API to: Android API.

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

Klucze interfejsu API Androida są połączone z określonymi parami pakietów certyfikatów. Niezależnie od liczby użytkowników aplikacji potrzebujesz tylko jednego klucza dla każdego certyfikatu.

Aby otrzymać klucz aplikacji, musisz wykonać kilka czynności. Znajdziesz je w tym przewodniku w podsumowaniu:

  1. Uzyskaj informacje o certyfikacie aplikacji.
  2. zarejestrować projekt w konsoli Google Developers i dodać interfejs User Context API jako usługę;
  3. Poproś o klucz.
  4. Dodaj klucz do aplikacji. Aby to zrobić, dodaj element do pliku manifestu aplikacji.

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 użyj odpowiedniego certyfikatu. Do wyboru masz te 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ł szczegółowo opisany w sekcji Podpisywanie kompilacji debugowania w dokumentacji dla deweloperów aplikacji na Androida.
  • 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 chcesz opublikować aplikację na całym świecie.

Więcej informacji o keytool znajdziesz w dokumentacji Oracle.

Certyfikat debugowania

Wyświetl odcisk cyfrowy certyfikatu debugowania

Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu, użyj programu keytool z parametrem -v. Aby to zrobić:

  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:

    • OS X 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 OS X 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 te polecenia:

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

Zostaną wyświetlone dane wyjściowe podobne do tych:

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świetl odcisk cyfrowy certyfikatu wersji

Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu, użyj programu keytool z parametrem -v. Aby to zrobić:

  1. Znajdź plik magazynu kluczy wersji certyfikatu. Nie ma domyślnej lokalizacji ani 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, haseł do magazynu kluczy i certyfikatu.

  2. Wpisz te informacje, aby wyświetlić listę wszystkich kluczy w magazynie kluczy:

    keytool -list -keystore your_keystore_name
  3. Zastąp your_keystore_name w pełni kwalifikowaną ścieżką i nazwą magazynu kluczy. Dodaj rozszerzenie .keystore. Podaj hasło magazynu kluczy. Następnie keytool wyświetla wszystkie aliasy w magazynie kluczy.

  4. Wpisz w terminalu lub w wierszu poleceń:

          keytool -list -v -keystore your_keystore_name -alias your_alias_name
  5. Zastąp your_keystore_name w pełni kwalifikowaną ścieżką i nazwą magazynu kluczy. Dodaj rozszerzenie .keystore.
  6. Zastąp your_alias_name aliasem przypisanym do certyfikatu podczas jego tworzenia.

Zostaną wyświetlone dane wyjściowe podobne do tych:

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.

Uzyskiwanie klucza interfejsu API z Google Developers Console

Aby zacząć korzystać z interfejsu Google Know API, kliknij przycisk Wygeneruj klucz. Łączy się ona z konsolą Google Developers Console, w której przeprowadzamy przez proces i automatycznie aktywujemy interfejs Know API.

Kup klucz

Aby uzyskać klucz interfejsu API, możesz też wykonać te czynności:

  1. Otwórz Google Developers Console.
  2. Wybierz projekt lub utwórz nowy.
  3. Kliknij Dalej, aby włączyć interfejs Know API.

  4. Na stronie „Dane logowania” utwórz klucz Androida i ustaw dane logowania do interfejsu API.

  5. W oknie „Utwórz klucz” musisz ograniczyć możliwość korzystania z aplikacji na Androida. Aby to zrobić, wpisz odcisk cyfrowy SHA-1 swojej aplikacji oraz nazwę pakietu, jak w tym przykładzie:

    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.awareness-example

  6. Kliknij Utwórz. Twój nowy klucz interfejsu Android API pojawi się na liście kluczy interfejsu API w Twoim projekcie. Klucz interfejsu API to ciąg znaków, taki jak:

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

Teraz gdy masz już klucz interfejsu API, możesz go dodać do pliku manifestu aplikacji zgodnie z opisem w przewodniku dla początkujących.

Aktywowanie dodatkowych interfejsów API

Interfejs Conversation API umożliwia dostęp do wielu typów danych kontekstowych, takich jak obrazy typu beacon. Aby używać tych typów, musisz włączyć odpowiednie interfejsy API w Google Developers Console.

Usługa Metody w interfejsie Know API Interfejs API do włączenia
Obrazy typu beacon SnapshotApi.getBeaconState(), FenceApi.BeaconFence Interfejs Nearby Messages API