API Home использует OAuth 2.0 для предоставления доступа к устройствам в структуре. OAuth позволяет пользователю предоставлять разрешения приложению или сервису без необходимости раскрывать свои учетные данные для входа.
Если у вас уже есть проверенный OAuth-клиент (например, из уже опубликованного приложения), вы можете использовать его для тестирования API Home без настройки нового. Для получения дополнительной информации см. раздел «Если у вас уже есть OAuth-клиент» .
Подпишите приложение
Сначала сгенерируйте отладочный сертификат, запустив приложение в Android Studio . При запуске или отладке приложения в Android Studio автоматически генерируется отладочный сертификат, предназначенный для разработки и отладки. Подробное объяснение см. в разделе «Android Studio: Подпишите отладочную сборку» .
После запуска приложения:
Подключите мобильное устройство к локальному компьютеру. Android Studio отобразит список подключенных устройств по номеру модели. Выберите своё устройство из списка, затем нажмите «Запустить проект» . Это соберет и установит пример приложения на ваше мобильное устройство.
Более подробные инструкции см. в разделе «Запуск приложений на аппаратном устройстве» на сайте разработчиков Android.
Остановите приложение для бега.
Получите отпечаток SHA-1 отладочного сертификата, следуя инструкциям, подробно описанным в разделе «Настройка OAuth 2.0 / Нативные приложения / Android» на сайте справки консоли Google Cloud.
Настройте экран согласия OAuth.
- В консоли Google Cloud перейдите на панель выбора проекта и выберите проект, который вы хотите использовать для создания учетных данных OAuth.
- Перейдите на страницу «API и сервисы» и в меню навигации нажмите «Учетные данные» .
Если вы еще не настроили экран согласия для этого проекта Google Cloud, появится кнопка « Настроить экран согласия» . В этом случае настройте экран согласия, используя описанную ниже процедуру. В противном случае перейдите к следующему разделу.
- Нажмите «Настроить экран согласия» . Отобразится страница экрана согласия OAuth .
- В зависимости от вашего сценария использования выберите «Внутренний» или «Внешний» , а затем нажмите «Создать» . Отобразится панель согласия OAuth .
- Введите информацию на странице сведений о приложении в соответствии с инструкциями на экране, а затем нажмите «Сохранить и продолжить» . Отобразится панель «Области видимости» .
- Добавлять какие-либо области действия не нужно, поэтому нажмите «Сохранить и продолжить ». Отобразится панель «Проверка пользователей» .
- Нажмите «Аудитория» и затем кнопку «+ ДОБАВИТЬ ПОЛЬЗОВАТЕЛЕЙ» .
- Введите адрес электронной почты тестового пользователя и нажмите кнопку СОХРАНИТЬ .
- Нажмите «Сохранить и продолжить» . Отобразится панель «Сводка» .
- Проверьте информацию на экране согласия 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.