Настройте OAuth для своего приложения Android.

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

Если у вас уже есть проверенный клиент OAuth (например, из уже опубликованного приложения), вы можете использовать этот клиент для тестирования Home API, не настраивая новый. Дополнительную информацию см. в разделе «Если у вас есть существующий клиент OAuth» .

Подпишите приложение

Сначала сгенерируйте ключ OAuth, запустив приложение в Android Studio . Когда вы запускаете или отлаживаете приложение в Android Studio , оно автоматически генерирует ключ OAuth, предназначенный для разработки и отладки. См . Android Studio: подпишите отладочную сборку для получения полного объяснения.

Как только приложение запустится:

  1. Подключите мобильное устройство к локальному компьютеру. Android Studio перечислит подключенные устройства по номеру модели. Выберите свое устройство из списка, затем нажмите «Запустить проект» . В результате будет создан и установлен пример приложения на ваше мобильное устройство.

    Более подробные инструкции см. в разделе «Запуск приложений на аппаратном устройстве» на сайте разработчиков Android.

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

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

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

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

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

Подробную информацию см. в разделе «Настройка экрана согласия OAuth» на справочном сайте Google Cloud Console.

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

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

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

Подключив мобильное устройство к локальному компьютеру, выберите свое устройство из списка, затем снова нажмите «Запустить проект», чтобы запустить его. Более подробные инструкции см. в разделе «Запуск приложений на аппаратном устройстве» на сайте разработчиков Android.

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

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

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

Применимы следующие соображения:

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

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

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

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