Как настроить OAuth для приложения Android

API Home использует OAuth 2.0 для предоставления доступа к устройствам в структуре. OAuth позволяет пользователю предоставить приложению или сервису разрешение без необходимости раскрывать свои учетные данные.

Если у вас уже есть подтвержденный клиент OAuth (например, из опубликованного приложения), вы можете использовать его для тестирования API Home, не создавая нового. Подробнее о том, что делать, если у вас уже есть клиент OAuth…

Как подписать приложение

Сначала создайте сертификат для отладки, запустив приложение в Android Studio. При запуске или отладке приложения в Android Studio автоматически создается сертификат для отладки, предназначенный для разработки и отладки. Подробную информацию можно найти в статье Android Studio: подписание отладочной сборки.

После запуска приложения:

1. Подключите мобильное устройство к локальному компьютеру. В Android Studio будет указан список подключенных устройств с номерами моделей. Выберите устройство из списка и нажмите Запустить проект. После этого на мобильном устройстве будет создано и установлено приложение Sample App.

   Подробные инструкции можно найти в статье Как запускать приложения на физических устройствах на сайте "Android для разработчиков".

2. Остановите запущенное приложение.

3. Получите цифровой отпечаток SHA-1 сертификата для отладки, следуя инструкциям в разделе Настройка OAuth 2.0 / Нативные приложения / Android на справочном сайте консоли Google Cloud.

Как настроить окно запроса доступа OAuth

1. В консоли Google Cloud перейдите на панель выбора проекта и выберите проект, который хотите использовать для создания учетных данных OAuth.
2. Перейдите на страницу API и сервисы и нажмите Учетные данные в меню навигации.

3. Если вы ещё не настроили окно запроса доступа для этого проекта Google Cloud, появится кнопка Настроить окно запроса доступа. В этом случае настройте окно запроса доступа, выполнив следующие действия: В противном случае перейдите к следующему разделу.

   1. Нажмите Настроить окно запроса доступа. Откроется страница Окно запроса доступа OAuth.
   2. В зависимости от вашего варианта использования выберите Внутреннее или Внешнее и нажмите Создать. Откроется панель Окно запроса доступа OAuth.
   3. Введите информацию на странице сведений о приложении, следуя инструкциям на экране, а затем нажмите Сохранить и продолжить. Появится панель Области действия.
   4. Добавлять области действия не нужно, поэтому нажмите Сохранить и продолжить. Откроется панель Тестовые пользователи.
   5. Нажмите Аудитория и выберите + Добавить пользователей.
   6. Введите адрес электронной почты тестового пользователя и нажмите кнопку Сохранить.
   7. Нажмите Сохранить и продолжить. Откроется панель Сводка.
   8. Проверьте информацию в окне запроса доступа OAuth и нажмите Вернуться на главную страницу.

Подробную информацию можно найти в статье Настройка окна запроса доступа OAuth на сайте Справочного центра консоли Google Cloud.

Зарегистрируйте приложение и создайте учетные данные

Чтобы зарегистрировать приложение для OAuth 2.0 и создать учетные данные OAuth, следуйте инструкциям в разделе Настройка OAuth 2.0. Вам нужно будет указать тип приложения – нативное приложение/приложение для Android.

Добавьте отпечаток SHA-1, полученный при подписании приложения, в клиент OAuth, настроенный в консоли Google Cloud, следуя инструкциям в разделе Настройка OAuth 2.0 / нативных приложений на сайте Справочного центра Google Cloud Console.

Когда мобильное устройство будет подключено к локальному компьютеру, выберите его в списке и нажмите Запустить проект ещё раз. Более подробные инструкции можно найти на сайте "Android для разработчиков" в разделе Запуск приложений на физических устройствах.

Если у вас есть клиент OAuth

Если у вас уже есть проверенный клиент OAuth для опубликованного приложения, вы можете использовать его для тестирования Home API.

Для тестирования и использования Home API регистрация Google Home Developer Console не требуется. Однако для публикации приложения вам все равно потребуется одобренная регистрация,Developer Console даже если у вас есть проверенный клиент OAuth из другой интеграции.

Обратите внимание на следующее:

• При использовании существующего клиента OAuth действует ограничение на количество пользователей – 100. Информацию о том, как добавить тестовых пользователей, можно найти в разделеНастройте окно запроса доступа OAuth. Независимо от проверки OAuth, API Home устанавливают ограничение в 100 пользователей, которые могут предоставить разрешения вашему приложению. Ограничение снимается после завершения регистрации Developer Console.

• Developer Console registration следует отправить на проверку, когда вы будете готовы ограничить предоставление разрешений по типу устройства через OAuth в рамках подготовки к обновлению приложения с помощью Home API.

Для приложений Google Cloud, которые ещё не прошли проверку OAuth, пользователи не смогут завершить процесс OAuth, пока проверка не будет завершена. При попытке предоставить разрешения появится следующая ошибка:

Access blocked: <Project Name> has not completed the Google verification process.