API Home использует OAuth 2.0 для предоставления доступа к устройствам в структуре. OAuth позволяет пользователю предоставлять разрешение приложению или службе, не раскрывая свои учётные данные.
Если у вас уже есть проверенный OAuth-клиент (например, из уже опубликованного приложения), вы можете использовать его для тестирования Home API без необходимости настройки нового. Подробнее см. в разделе «Если у вас уже есть 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» . Вам необходимо указать тип приложения: « native/Android app» (нативное приложение для Android) .
Добавьте отпечаток SHA-1, полученный при подписании приложения, в клиент OAuth, настроенный в консоли Google Cloud, следуя инструкциям в разделе Настройка OAuth 2.0 / собственных приложений на сайте справки Google Cloud Console.
Подключив мобильное устройство к локальному компьютеру, выберите его из списка и снова нажмите «Запустить проект» , чтобы запустить его. Более подробные инструкции см. в статье «Запуск приложений на аппаратном устройстве» на сайте разработчиков Android.
Если у вас уже есть клиент OAuth
Если у вас уже есть проверенный клиент OAuth для опубликованного приложения, вы можете использовать существующий клиент OAuth для тестирования API Home.
Для тестирования и использования Home API регистрация Google Home Developer Console не требуется. Однако для публикации приложения вам всё равно потребуется подтверждённая регистрация 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.