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 Console.
Настройте экран согласия OAuth
- В консоли Google Cloud перейдите на панель выбора проектов и выберите проект, который вы хотите использовать для создания учетных данных OAuth.
- Перейдите на страницу API и сервисы и нажмите «Учетные данные» в меню навигации.
Если вы еще не настроили экран согласия для этого проекта Google Cloud, появится кнопка Настроить экран согласия . В этом случае настройте экран согласия, используя следующую процедуру. В противном случае перейдите к следующему разделу.
- Нажмите Настроить экран согласия . Отобразится страница экрана согласия OAuth .
- В зависимости от вашего варианта использования выберите Внутренний или Внешний , а затем нажмите Создать . Отобразится панель экрана согласия OAuth .
- Введите информацию на странице информации о приложении в соответствии с инструкциями на экране, а затем нажмите Сохранить и продолжить . Отобразится панель областей .
- Вам не нужно добавлять какие-либо области, поэтому нажмите Сохранить и продолжить . Отобразится панель Тестовые пользователи .
- Нажмите «Аудитория» и нажмите кнопку + ДОБАВИТЬ ПОЛЬЗОВАТЕЛЕЙ .
- Введите адрес электронной почты тестового пользователя и нажмите кнопку СОХРАНИТЬ .
- Нажмите Сохранить и продолжить . Отобразится панель Сводка .
- Проверьте информацию на экране согласия 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 для тестирования API Home.
Регистрация Google Home Developer Console не требуется для тестирования и использования API Home. Однако вам все равно понадобится одобренная регистрация Developer Console для публикации вашего приложения, даже если у вас есть проверенный клиент OAuth из другой интеграции.
При этом следует учитывать следующие соображения:
При использовании существующего клиента OAuth существует ограничение в 100 пользователей. Для получения информации о добавлении тестовых пользователей см.Настройте экран согласия OAuth .Независимо от проверки OAuth, существует ограничение Home APIs в 100 пользователей, которые могут предоставить разрешения вашему приложению. Это ограничение снимается после завершения регистрации в Developer Console .
Регистрация Developer Console следует отправить на утверждение, когда вы будете готовы ограничить предоставление разрешений типам устройств через OAuth в рамках подготовки к обновлению вашего приложения с помощью API Home.
Для приложений Google Cloud , которые все еще ожидают проверки OAuth, пользователи не могут завершить поток OAuth, пока проверка не будет завершена. Попытки предоставить разрешения завершатся ошибкой со следующей ошибкой:
Access blocked: <Project Name> has not completed the Google verification process.