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

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

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

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

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

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

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

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

  2. Остановите приложение для бега.

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

  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.

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

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

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

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

Принимаются во внимание следующие факторы:

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

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

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

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