Nguồn cấp dữ liệu hành động

Tạo và tải nguồn cấp dữ liệu hành động lên

Khi tạo và tải nguồn cấp dữ liệu hành động lên, hãy đảm bảo bạn làm theo các hướng dẫn sau:

  • Hãy tuân theo thông số kỹ thuật được mô tả trong nguồn cấp dữ liệu hành động cho các tệp dữ liệu hành động. Bạn phải sử dụng tên tệp dữ liệu hành động duy nhất giữa các lần tải lên. Bạn nên đưa dấu thời gian vào tên tệp, ví dụ: action1_1633621547.json.
  • Trong chỉ số mô tả nhóm tệp, hãy đặt trường name thành reservewithgoogle.action.v2. Để xem ví dụ về tệp chỉ số mô tả, hãy tham khảo Mẫu JSON của tệp mô tả. Bạn phải sử dụng tên tệp mô tả duy nhất giữa các lần tải lên. Bạn nên đưa dấu thời gian vào tên tệp, ví dụ: action1_1633621547.filesetdesc.json. Tệp mô tả phải được tải lên tài khoản đăng SFTP chung.
  • Hằng ngày, nguồn cấp dữ liệu phải được tải lên tài khoản đăng SFTP chung dưới dạng được làm mới toàn bộ.
  • Bạn có thể tìm thấy thông tin về tài khoản đăng SFTP của nguồn cấp dữ liệu chung trong phần Cấu hình > Nguồn cấp dữ liệu của cổng thông tin đối tác.

    • Chọn hộp kéo thả nguồn cấp dữ liệu

  • Bạn có thể xem trạng thái nhập nguồn cấp dữ liệu chung trong phần Nguồn cấp dữ liệu > Nhật ký trên cổng thông tin của đối tác.

Định nghĩa

Định nghĩa ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Định nghĩa về hành động

message ActionDetail {
  string entity_id = 2;
  string link_id = 3;

  // Deep link for action detail
  string url = 4;
  repeated Action actions = 1;
}

Định nghĩa hành động

// 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;
  }
}

Định nghĩa Food OrderingInfo

message FoodOrderingInfo {
  // Service type for food ordering action.
  enum ServiceType {
    UNKNOWN = 0;
    DELIVERY = 1;
    TAKEOUT = 2;
  }

  ServiceType service_type = 1 [features.field_presence = IMPLICIT];
}

Mẫu Nguồn cấp dữ liệu hành động

Chỉ có dịch vụ giao hàng tận nơi

Tên tệp : actions1_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"
    }
  ]
}

Chỉ phục vụ mua mang đi

Tên tệp : actions1_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"
    }
  ]
}

Giao hàng và mua mang đi

Tên tệp : actions1_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 khác với giao hàng và trích xuất

Tên tệp : actions1_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"
    }
  ]
}

Tệp mô tả

Tên tệp : actions1_1697754089.filesetdescription.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": ["actions1_1697754089.json"]
}
Trước
Nguồn cấp dữ liệu thực thể
Tiếp
Nguồn cấp dữ liệu dịch vụ