В этой статье описывается процесс включения API меню для вашей учетной записи и интеграции с ним. Ниже приведен подробный обзор процесса адаптации и предварительных условий для запуска. Пожалуйста, обратитесь к этой странице при планировании усилий по интеграции.
- Настройка — настройка аккаунта и планирование процесса разработки.
- Разработка - разработка и тестирование каналов данных.
- Запуск – оценка данных перед запуском.
Настраивать
На этом этапе важно подтвердить, что ваша учетная запись на партнерском портале полностью настроена и готова принимать каналы данных, соответствующие статическим данным меню. Если у вас уже есть активная интеграция OwG Redirect или RwG, к которой вы добавляете метаданные меню, ваша существующая учетная запись будет повторно использована для этой интеграции. В случае интеграции OwG Direct с этой платформой или отсутствия интеграции вообще создается новая учетная запись, а данные доступа передаются по электронной почте.
Войдите в свою учетную запись на партнерском портале и перейдите на страницу конфигурации Dropbox «Конфигурация» > «Фиды» . Для интеграции фида данных меню подходят два раскрывающихся ящика: «Общий» и «Продавцы» . Убедитесь, что в обоих ящиках настроен открытый ключ SSH. Дополнительную информацию о настройке ключей SSH смотрите на этой странице .
Общий почтовый ящик может принимать различные каналы, которые могут соответствовать разным схемам данных. Тип фида, принимающий данные структурированного меню, называется google.food_menu и обычно включается для вашей учетной записи по умолчанию в начале регистрации. Если вы попытаетесь отправить фид и увидите это сообщение об ошибке: «Ошибка обработки фида. При анализе вашего фида мы столкнулись с внутренней проблемой. «google.food_menu» не включен. Исправьте это и повторите попытку». , обратитесь к своему контактному лицу в Google, чтобы включить этот тип фида.
Наконец, перейдите на страницу «Конфигурация» > «Контактная информация» и убедитесь, что все ваши контактные данные актуальны.
Разработка
Этап разработки содержит основную часть усилий по внедрению — создание и тестирование каналов данных. Фиды данных необходимо создавать и отправлять в целевой ящик каждый день. Ожидается, что фиды, отправленные в песочницу, начнут обрабатываться в течение часа после отправки. Производственные фиды обрабатываются один раз в день в 12:00 по часовому поясу PST. Для обработки принимается только последний отправленный фид. При создании фидов ознакомьтесь со спецификацией и образцами фида данных. Хотя спецификация представлена в формате protobuf, мы рекомендуем загружать файлы фида в формате JSON, поскольку в нем легче устранять неполадки. По этой причине образцы фидов также предоставляются в формате JSON.
Один файл фида данных можно быстро протестировать с помощью онлайн-инструмента проверки фидов , который проверяет, соответствует ли этот файл спецификации. Инструмент показывает, соответствует ли файл схеме данных, а если нет — выводит список ошибок. Чтобы протестировать весь канал данных, состоящий из нескольких файлов, загрузите этот канал в изолированную среду и после завершения приема просмотрите результаты на партнерском портале . Во время приема фида применяются дополнительные правила проверки для проверки некоторой бизнес-логики и качества данных.
Запуск
Стадию запуска можно начинать после того, как все работы по интеграции завершены и производственный канал правильно отражает весь ассортимент ресторанных меню.
Предварительные условия запуска
Для запуска интеграции необходимо выполнить следующие условия:
- Фиды данных обрабатываются в производственной среде с нулевым уровнем ошибок.
- В начале этой интеграции фид производственных данных содержит все запасы, необходимые для этой интеграции.
- Большая часть ваших данных о продавцах совпадает с местоположениями на Картах Google.
- Производственные каналы прошли оценку качества данных.
- Интеграция соответствует всем правилам и требованиям меню продуктов питания .
Оценка данных
После того как потоки производственных данных принимаются без ошибок, может потребоваться внутренний процесс оценки качества данных меню. Этот процесс направлен на обнаружение несоответствий в качестве данных, таких как содержание, не связанное с едой, в описаниях блюд, несоответствия в названиях блюд, ценах и т. д. В случае таких обнаружений отзывы будут переданы команде разработчиков.