Создание и загрузка фидов действий
Создавая и загружая фиды действий, убедитесь, что вы следуете этим инструкциям:
- Следуйте спецификации, описанной в ленте действий для файлов данных действий. Между загрузками необходимо использовать уникальные имена файлов данных действий. В имя файла рекомендуется включать временную метку, например
action1_1633621547.json
. - В дескрипторе набора файлов установите в поле
name
значениеreservewithgoogle.action.v2
. Пример файла дескриптора см. в образце JSON файла дескриптора . Между загрузками необходимо использовать уникальные имена файлов дескрипторов. В имя файла рекомендуется включать временную метку, напримерaction1_1633621547.filesetdesc.json
. Файл дескриптора необходимо загрузить в общий ящик SFTP. - Фиды необходимо загружать в общий ящик SFTP ежедневно с полным обновлением.
- Информацию об общем списке каналов SFTP можно найти в разделе «Конфигурация» > «Фиды» партнерского портала.
- Статус приема общего канала можно найти в разделе «Фиды» > «История» партнерского портала.
Определения
Определение ActionFeed
message ActionFeed { repeated ActionDetail data = 1; }
Определение ActionDetail
message ActionDetail { string entity_id = 2; string link_id = 3; // Deep link for action detail string url = 4; repeated Action actions = 1; }
Определение действия
// Information about an Action which could be performed. message Action { // Deprecated fields not to be reused. reserved 1; oneof action_info { FoodOrderingInfo food_ordering_info = 3; } }
Определение FoodOrderingInfo
message FoodOrderingInfo { // Service type for food ordering action. enum ServiceType { UNKNOWN = 0; DELIVERY = 1; TAKEOUT = 2; } ServiceType service_type = 1 [features.field_presence = IMPLICIT]; }
Примеры фида действий
Только доставка
Имя файла: action1_1697754089.json.
{ "data": [ { "actions": [{ "food_ordering_info": { "service_type": "DELIVERY" } }], "entity_id": "dining-1", "link_id": "delivery_link/dining-1", "url": "https://www.restaurant.com/delivery/dining-1" } ] }
Только на вынос
Имя файла: action1_1697754089.json.
{ "data": [ { "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }], "entity_id": "dining-1", "link_id": "takeout_link/dining-1", "url": "https://www.restaurant.com/takeout/dining-1" } ] }
Доставка и самовывоз
Имя файла: action1_1697754089.json.
{ "data": [ { "actions": [ { "food_ordering_info": { "service_type": "DELIVERY" } }, { "food_ordering_info": { "service_type": "TAKEOUT" } } ], "entity_id": "dining-1", "link_id": "common_link/dining-1", "url": "https://www.restaurant.com/commonlink/dining-1" } ] }
Доставка+самовывоз, другой URL
Имя файла: action1_1697754089.json.
{ "data": [ { "actions": [ { "food_ordering_info": { "service_type": "TAKEOUT" } } ], "entity_id": "dining-1", "link_id": "takeout_link/dining-1", "url": "https://www.restaurant.com/takeout/dining-1" }, { "actions": [ { "food_ordering_info": { "service_type": "DELIVERY" } } ], "entity_id": "dining-1", "link_id": "delivery_link/dining-1", "url": "https://www.restaurant.com/delivery/dining-1" } ] }
Файл дескриптора
Имя файла: action1_1697754089.filesetdesc.json
{ "generation_timestamp": 1697754089, "name": "reservewithgoogle.action.v2", "data_file": ["actions1_1697754089.json"] }