動作動態饋給

注意：如要整合使用舊版動作動態饋給，請參閱舊版 動態饋給參考資料。如果不確定整合功能啟用的是哪個版本的動態消息，請洽詢 Google 聯絡人。

建立及上傳動作動態饋給

建立及上傳動作動態饋給時，請按照下列操作說明進行：

• 請按照動作動態饋給所述規格，為動作資料檔案命名。建議每次上傳時，都為動作資料檔案命名專屬名稱。 在檔案名稱中加入時間戳記，例如 action_1633621547.json。
• 在檔案集描述元中，將 name 欄位設為 reservewithgoogle.action.v2。如需描述元檔案範例，請參閱 JSON 範例。 建議您為每次上傳作業使用專屬的描述元檔案名稱。 在檔案名稱中加入時間戳記，例如 action_1633621547.filesetdesc.json。 描述元檔案必須上傳至一般 SFTP 伺服器。
• 每天將動態饋給上傳至一般安全檔案傳輸通訊協定伺服器，進行完整重新整理。
• 你可以在合作夥伴入口網站的「設定」>「動態饋給」部分找到 SFTP 伺服器詳細資料。



在合作夥伴入口網站中選取動態饋給伺服器

• 在合作夥伴入口網站的「動態饋給」>「記錄」專區中，查看動態饋給擷取狀態。

定義

注意：下方以 protobuffer 格式定義動作動態饋給規格，但建議上傳 JSON 格式的動態饋給。詳情請參閱 JSON 範例動態饋給。

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

AppointmentInfo 定義

message AppointmentInfo {
}

動作動態消息範例

動作動態消息

{
  "data": [
    {
      "entity_id": "appointments-merchant-1",
      "link_id": "appointment-link-1",
      "url": "https://www.partnerwebsite.com/appointment/appointment-partner-1",
      "actions":[
        {
          "appointment_info": {}
        }
      ]
    }
  ]
}

描述元檔案

{
  "generation_timestamp": 1677540395,
  "name": "reservewithgoogle.action.v2",
  "data_file": [
    "action_1677540395_0001.json",
    "action_1677540395_0002.json"

  ]
}