Как создать интеграцию между облачными сервисами

В проекте Cloud-to-cloud может быть только одна интеграция. Если вам нужно работать с несколькими интеграциями, создайте для каждой из них отдельный проект.

Чтобы создать новую интеграцию Cloud-to-cloud, сначала нужно создать проект, как описано в разделе Создание проекта разработчика. После настройки проекта:

Перейти в Developer Console

  1. В списке проектов нажмите Open (Открыть) рядом с нужным проектом.

  2. Нажмите Добавить интеграцию облачных сервисов.

    Если вы впервые создаете интеграцию с Cloud-to-cloud, откроется страница Ресурсы, где можно ознакомиться с документацией для разработчиков для Cloud-to-cloud и прочитать о некоторых инструментах.

    Когда вы будете готовы продолжить, нажмите Далее: разработка. Откроется страница Контрольный список. Нажмите Далее: настройка.

    Если вы уже создавали интеграцию с Cloud-to-cloud, откроется страница Настройка и конфигурация.

  3. На странице Настройка и конфигурация введите название интеграции.

  4. Нажмите Выбрать тип устройства и выберите нужный вариант в раскрывающемся меню.

  5. В разделе Брендинг приложения загрузите изображение в формате PNG размером 144 x 144 пикселя, которое будет представлять ваш сервис в Google Home app (GHA). Убедитесь, что значок соответствует следующим требованиям (см. пример):

    • Добавьте круглый логотип.
    • Увеличьте логотип, чтобы он касался рамки.
    • Если логотип белый, требуется цветная рамка.
    • Если логотип прозрачный, требуется белый фон с цветной рамкой.
    • Фон за логотипом должен быть прозрачным.

    Изображение требований к значку

  6. В разделе Связывание аккаунтов настройте приложение так, чтобы в него можно было входить с помощью аккаунта Google. Вам потребуется настроить сервер OAuth, поэтому перед тем, как задавать эти настройки, изучите статьи Связывание аккаунтов и Как реализовать сервер OAuth 2.0.

  7. В разделе Cloud fulfillment URL (URL выполнения в облаке) укажите URL выполнения, который используется для обработки намерений умного дома.

    • Всегда будьте владельцем своего домена. URL товаров должны указывать на домен, который вы контролируете, а не напрямую на конечную точку Amazon Web Services, Google Cloud или другого поставщика облачных сервисов. В этом случае при смене хостинга вам нужно будет только обновить переадресацию, а не менять общедоступный URL.
    • Разместите балансировщик нагрузки в конечной точке. Балансировщик нагрузки помогает постепенно переходить на новую инфраструктуру, отслеживать производительность и обнаруживать серьезные сбои до того, как они повлияют на клиентов.
  8. При необходимости настройте переключение аккаунтов и разрешения.

  9. В разделе Log level control (Управление уровнем ведения журнала) измените настройки для ошибок и всех журналов.

    • Если вы уже сделали это при настройке профиля компании, можете пропустить этот шаг.
  10. Нажмите Save (Сохранить), чтобы сохранить конфигурацию интеграции с Cloud-to-cloud.

Дополнительные настройки

Как настроить переключение аккаунтов

В разделе App Flip (optional) (Переключение аккаунтов (необязательно)) можно настроить приложение так, чтобы пользователи Android могли быстрее связывать свои аккаунты в вашей системе аутентификации с аккаунтами Google. Подробнее о переключении аккаунтов в Android…

Разрешения

В этом разделе вы можете указать конкретные области разрешений OAuth, необходимые вашему сервису. Пользователи должны подтвердить эти разрешения, прежде чем смогут использовать ваш сервис.

Уровни ведения журнала

Вы можете указать, сколько данных журнала сохраняется для интеграции на странице Google Cloud. Вы можете сохранять только журналы ошибок или все журналы.

Чтобы задать уровни ведения журнала, перейдите в раздел Сведения о проекте > Управление уровнем ведения журнала: журналы ошибок. Подробнее о настройке уровней ведения журнала…

Как изменить интеграцию, находящуюся на проверке

Чтобы изменить интеграцию, выполните следующие действия:

Перейти в Developer Console

  1. В списке проектов нажмите Open (Открыть) рядом с нужным проектом.

  2. Измените информацию на странице Настройка и конфигурация.

  3. Нажмите Сохранить.

  4. Появится всплывающее окно с запросом на подтверждение обновления интеграции. Нажмите Обновить.

  5. Нажмите Далее: сертификация, чтобы отправить интеграцию на проверку.

  6. Нажмите Отправить, чтобы запросить проверку сертификации.

После отправки integration появится в разделе Отправлено на сертификацию.

После сертификации integration Google поможет запустить integration.