Лента действий

Создавайте и загружайте ленты действий.

При создании и загрузке лент действий следуйте этим инструкциям:

  • Следуйте спецификациям, описанным в ленте действий, для файлов данных действий. Мы рекомендуем использовать уникальные имена файлов данных действий для каждой загрузки. Включите метку времени в имя файла, например, action_1633621547.json .
  • В дескрипторе набора файлов установите поле name равным reservewithgoogle.action.v2 . Пример файла дескриптора можно найти в примере JSON . Мы рекомендуем использовать уникальные имена файлов дескрипторов для каждой загрузки. Включите метку времени в имя файла, например, action_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
      ;
}

Образцы Action Feed

Доставка только

Имя файла: actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "DELIVERY" } }],
      "entity_id": "dining-1",
      "link_id": "delivery-dining-1",
      "url": "https://www.restaurant.com/delivery/dining-1"
    }
  ]
}

Только на вынос

Имя файла: actions_1697754089_0001.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_1697754089_0001.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-адреса

Имя файла: actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "TAKEOUT"
          }
        }
      ],
      "entity_id": "dining-1",
      "link_id": "takeout-dining-1",
      "url": "https://www.restaurant.com/takeout/dining-1"
    },
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "DELIVERY"
          }
        }
      ],
      "entity_id": "dining-1",
      "link_id": "delivery-dining-1",
      "url": "https://www.restaurant.com/delivery/dining-1"
    }
  ]
}

Файл описания

Имя файла: actions_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": [
    "actions_1697754089_0001.json",
    "actions_1697754089_0002.json"
  ]
}