Feed Tindakan

Membuat dan mengupload feed tindakan

Saat membuat dan mengupload feed tindakan, ikuti petunjuk berikut:

• Ikuti spesifikasi yang dijelaskan dalam feed tindakan untuk file data tindakan. Sebaiknya gunakan nama file data tindakan yang unik untuk setiap upload. Sertakan stempel waktu dalam nama file, misalnya, action_1633621547.json.
• Dalam deskriptor kumpulan file, tetapkan kolom name ke reservewithgoogle.action.v2. Untuk contoh file deskriptor, lihat contoh JSON. Sebaiknya gunakan nama file deskriptor unik untuk setiap upload. Sertakan stempel waktu dalam nama file, misalnya, action_1633621547.filesetdesc.json. File deskripsi harus diupload ke server SFTP generik.
• Upload feed ke server SFTP generik setiap hari sebagai pembaruan penuh.
• Anda dapat menemukan detail server SFTP di bagian Konfigurasi > Feed di Partner Portal.



Memilih server feed di Partner Portal

• Lihat status penyerapan feed di bagian Feed > Histori di Partner Portal.

Definisi

Catatan: Spesifikasi feed tindakan ditentukan dalam format protobuffer sebagai berikut, tetapi sebaiknya Anda mengupload feed dalam format JSON. Untuk mengetahui informasi selengkapnya, lihat feed contoh JSON.

Definisi ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definisi ActionDetail

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

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

Definisi tindakan

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

Definisi FoodOrderingInfo

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

  ServiceType service_type = 1
      ;
}

Contoh Feed Tindakan

Hanya pesan antar

Nama file : 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"
    }
  ]
}

Hanya bisa bawa pulang

Nama file : 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"
    }
  ]
}

Pengiriman dan bawa pulang

Nama file : 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 berbeda untuk pengiriman+bawa pulang

Nama file : 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"
    }
  ]
}

File deskriptor

Nama file : actions_1697754089.filesetdesc.json

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