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

Создание и загрузка фидов действий

Создавая и загружая фиды действий, убедитесь, что вы следуете этим инструкциям:

  • Следуйте спецификации, описанной в ленте действий для файлов данных действий. Между загрузками необходимо использовать уникальные имена файлов данных действий. В имя файла рекомендуется включать временную метку, например 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": "entity002",
      "link_id": "delivery_link/entity002",
      "url": "https://www.restaurant.com/delivery/entity002"
    }
  ]
}

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

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

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }],
      "entity_id": "entity002",
      "link_id": "takeout_link/entity002",
      "url": "https://www.restaurant.com/takeout/entity002"
    }
  ]
}

Доставка и самовывоз

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

{
  "data": [
    {
      "actions": [
        { "food_ordering_info": { "service_type": "DELIVERY" } },
        { "food_ordering_info": { "service_type": "TAKEOUT" } }
      ],
      "entity_id": "entity002",
      "link_id": "common_link/entity002",
      "url": "https://www.restaurant.com/commonlink/entity002"
    }
  ]
}

Доставка+самовывоз, другой URL

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

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

Файл дескриптора

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

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": ["actions1_1697754089.json"]
}
Назад
Фид объектов
Далее
Сервис-фид, Сервис-фид, Сервис-фид, Сервис-фид