Как получить идентификатор клиента OAuth 2.0

Обзор

Чтобы использовать Google Fit для Android, вам понадобится идентификатор клиента OAuth 2.0 для приложений для Android.

Все приложения для Android подписываются цифровым сертификатом, для которого у вас есть закрытый ключ. Дополнительную информацию о цифровых сертификатах вы найдете в руководстве по добавлению подписи в приложения для Android.

Идентификаторы клиентов OAuth Android связаны с определенными парами сертификатов и пакетов. Для каждого сертификата нужен только один идентификатор, независимо от того, сколько пользователей у приложения.

Чтобы получить идентификатор приложения, выполните следующие действия: Ниже описаны необходимые действия.

  1. Найдите информацию о сертификате приложения.
  2. Создайте или измените проект в Google API Console.
  3. Запросите идентификатор клиента OAuth 2.0.

Как найти информацию о сертификате приложения

Ключ API основан на краткой форме цифрового сертификата приложения, известной как цифровой отпечаток SHA-1. Чтобы посмотреть цифровой отпечаток SHA-1 для сертификата, сначала убедитесь, что вы используете правильный сертификат. У вас может быть два сертификата.

  • Сертификат для отладки. Этот сертификат создается автоматически при выполнении отладочной сборки приложения с помощью Android SDK Tools. Его следует использовать исключительно при тестировании приложений. Не пытайтесь опубликовать приложение, подписанное с помощью сертификата для отладки. Подробную информацию о сертификате для отладки можно найти в разделе Подписание в режиме отладки документации для разработчиков Android.
  • Сертификат для выпуска. Он создается с помощью инструментов Android SDK при выполнении конечной сборки. Этот сертификат можно также создать с помощью программы keytool. Используйте этот сертификат, когда ваше приложение будет готово к публикации.

Следуйте приведенным ниже инструкциям, чтобы отобразить цифровой отпечаток SHA-1 сертификата в программе keytool с помощью параметра -v. Подробные сведения о программе Keytool можно найти в документации Oracle.

Сертификат для отладки

Отображение цифрового отпечатка сертификата для отладки

  1. Найдите свой файл хранилища ключей для отладки. Этот файл, который называется debug.keystore, создается при выполнении первой сборки проекта. По умолчанию он хранится в том же каталоге, где и файлы виртуального устройства Android (AVD):

    • macOS и Linux: ~/.android/
    • Windows Vista и Windows 7: C:\Users\your_user_name\.android\
  2. Откройте цифровой отпечаток SHA-1.

    • В Linux или macOS перейдите в окно терминала и введите следующую команду:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • В Windows Vista и Windows 7 выполните следующую команду:

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

Вы должны получить примерно такой результат:

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
Сертификат для выпуска

Отображение цифрового отпечатка сертификата для выпуска

  1. Найдите свой файл хранилища ключей сертификата для выпуска. Этот файл может называться по-разному, и для него нет стандартного местоположения. Если не указать этот файл при создании сборки приложения для выпуска, ваш пакет .apk останется без подписи и его необходимо будет подписать, чтобы обеспечить возможность публикации. Чтобы отобразить сертификат выпуска, также потребуется псевдоним и пароли для файла keystore и самого сертификата. Чтобы получить список псевдонимов для всех ключей, имеющихся в хранилище, введите следующую команду:

    keytool -list -keystore your_keystore_name

    Вместо your_keystore_name укажите полный путь к файлу, включая расширение .keystore. Потребуется ввести пароль для хранилища ключей. После этого в окне программы keytool появится список всех псевдонимов, имеющихся в хранилище.

  2. В окне терминала или в командной строке введите следующую команду:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    Вместо your_keystore_name укажите полный путь к файлу, включая расширение .keystore. Замените your_alias_name на псевдоним, присвоенный сертификату при его создании.

Вы должны получить примерно такой результат:

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, содержится цифровой отпечаток SHA-1. Отпечаток – это последовательность из 20 двузначных шестнадцатеричных чисел, разделенных двоеточиями.

Как запросить идентификатор клиента OAuth 2.0 в Google API Console

Чтобы создать или изменить проект для приложения в Google API Console, включить Fitness API и запросить идентификатор клиента OAuth 2.0, выполните следующие действия:

Если вы хотите, чтобы мы помогли вам настроить Fitness API и активировали его автоматически, нажмите

Как получить идентификатор клиента

Вы также можете включить Fitness API в Google API Console и получить идентификатор клиента OAuth 2.0, выполнив следующие действия:

  1. Откройте Google API Console.
  2. Выберите существующий или создайте новый проект. Используйте один и тот же проект для версий приложения для Android и REST.
  3. Нажмите Продолжить, чтобы включить Fitness API.
  4. Нажмите Перейти к учетным данным.
  5. Нажмите Новые учетные данные и выберите Идентификатор клиента OAuth.
  6. В разделе Тип приложения выберите Android.
  7. В открывшемся диалоговом окне введите цифровой отпечаток SHA-1 и название пакета приложения. Пример:

    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. Нажмите Создать. Новый идентификатор клиента и секретный код OAuth 2.0 для Android появятся в списке идентификаторов для вашего проекта. Идентификатор клиента OAuth 2.0 – это строка символов, которая выглядит примерно так:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com