Ленты предоставляют данные о вашем инвентаре в Центр действий. Ежедневная загрузка по протоколу SFTP обновляет данные обо всех продавцах, услугах и слотах доступности. Ленты указывают, каких продавцов вы поддерживаете, их доступность и любые специальные функции, необходимые для корректного отображения вашего инвентаря в Google. Ленты загружаются в папки SFTP, которые настраиваются при указании ключа SSH в настройках .
Перед переходом на сервер бронирования необходимо выполнить следующие задачи по подготовке каналов:
Задачи будут отмечены как выполненные и станут зелёными после успешной загрузки ваших фидов. Ознакомьтесь со ссылкой на документацию, чтобы выполнить каждую конкретную задачу этапа.
Для корректной работы сквозной интеграции бронирования ресторанов вам необходимо ежедневно автоматически загружать данные о торговом фиде, фиде услуг и фиде доступности. Инфраструктура автоматизированных фидов должна предоставлять полный доступ к вашему инвентарю.
Типы кормов
Для сквозной интеграции бронирования столиков в ресторанах требуются следующие каналы и частота их загрузки:
| Кормить | Описание | Частота | Образец |
|---|---|---|---|
| Торговец | Описывает ваших торговцев. | Раз в 24 часа | Образец фида продавца |
| Услуги | Опишите услуги ваших продавцов. | Раз в 24 часа | Образец сервисного фида |
| Доступность | Описывает доступные интервалы для услуг ваших продавцов. Необходимо предоставить минимальное покрытие на 30 дней. Чтобы продлить покрытие до 90 дней, обратитесь в службу поддержки Google через контактную форму Центра действий. | Раз в 24 часа | Наличие образца корма |
Форматы фидов описаны с использованием синтаксиса протокола Buffer 3 , но вы можете загружать свои фиды в соответствующем формате JSON. Подробнее о формате JSON см. в примерах фидов. Мы рекомендуем загружать фиды в формате JSON.
Соглашения об именовании и метаданные
Имена файлов
При использовании шардинга загружаемые каналы должны иметь уникальные имена, указывающие тип и количество каналов. Временная метка для создания канала удовлетворяет требованию уникальности имён файлов каналов.
Структура : {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
Пример : availability_feed_1574117613_001_of_002.json.gz
Определить идентификаторы
При определении идентификаторов для продавцов или других атрибутов, требующих идентификатора, мы настоятельно рекомендуем использовать UID или UUID. Вы можете предоставить собственное буквенно-цифровое решение, при условии, что идентификаторы будут отличаться на всей вашей платформе.
Метаданные
При создании фидов поле generation_timestamp должно отражать время извлечения данных из базы данных. Повторное использование этого значения в разных фидах может привести к ошибкам обработки.
Значения nonce, случайные или неповторяющиеся числа, должны быть уникальными для всех типов фидов и не могут использоваться повторно. Значение должно совпадать для всех файлов в конкретном сегментированном фиде.
Размер файла ленты
Файлы каналов Sharding
В зависимости от вашего инвентаря может потребоваться шардирование или разбиение каналов на несколько файлов. Шардирование каналов может потребоваться в следующих случаях:
- Сжатый gzip-файл превышает 200 МБ для одного файла.
- Пример : сгенерированный фид доступности имеет размер 1 ГБ. Он должен быть разделен на пять или более отдельных сегментов.
- Партнерский инвентарь распределен по разным системам или регионам, что затрудняет его согласование.
- Пример : у партнёра есть инвентарь в США и ЕС, хранящийся в разных системах. Лента может быть сгенерирована двумя сегментами: одним для США и одним для ЕС с одинаковыми одноразовыми кодами и
generation_timestamp.
- Пример : у партнёра есть инвентарь в США и ЕС, хранящийся в разных системах. Лента может быть сгенерирована двумя сегментами: одним для США и одним для ЕС с одинаковыми одноразовыми кодами и
Дополнительную информацию см. в руководствах и рекомендациях по использованию файлов каналов Shard .
Канал может состоять из нескольких файлов, называемых шардами . Чтобы определить размер каналов, следуйте следующим рекомендациям:
- Предлагаемое сегментирование каналов:
- Лента продавца : один осколок.
- Лента услуг : один осколок.
- Лента доступности : менее 20 сегментов. Если у вас есть бизнес-обоснование, требующее больше указанного объёма, обратитесь в службу поддержки за дальнейшими инструкциями.
- Размер файлов каналов и шардинг:
- После сжатия размер файла шарда должен быть менее 200 МБ. При необходимости используйте несколько шардов.
- Отдельные записи, отправленные в одном шарде, не обязательно отправлять в тот же шард в будущих лентах.
- Для повышения производительности равномерно распределите данные между шардами, чтобы все файлы шардов были схожими по размеру.
- При необходимости используйте gzip для сжатия текстовых JSON-каналов для каждого отдельного фрагмента канала.
Сжатие файлов каналов
Любой файл JSON или PB3 можно сжать с помощью gzip перед загрузкой. Это может значительно уменьшить размер ежедневных лент.
Каждый файл шарда должен быть сжат с помощью gzip и загружен отдельно, например, как gzip*.json. Сжатые шарды должны иметь расширение .json.gz или .pb3.gz.
Загрузите каналы в свой почтовый ящик SFTP.
После создания фидов Merchant , Service и Availability вы можете загрузить их в тестовую среду Sandbox или Production через SFTP-сервер. SFTP-сервер настраивается при указании ключа SSH в настройках . SFTP-сервер Google доступен по адресу sftp://partnerupload.google.com через порт 19321.
Google проверяет и проверяет файлы фидов сразу после их загрузки в Dropbox SFTP. Если фид разделён на несколько файлов, они обрабатываются после загрузки последнего. Если фид содержит ошибки, вам будет отправлено электронное письмо с кодами ошибок фида . Ошибки препятствуют загрузке определённых продавцов, услуг или доступности. После проверки фиды могут появиться во внешнем интерфейсе в течение 24 часов.