アクション フィード

アクション フィードを作成してアップロードする

アクション フィードを作成してアップロードする際は、次の手順に沿って操作してください。

  • アクション データ ファイルについては、 アクション フィード に記載されている仕様に沿って操作してください。アップロードごとに一意のアクション データ ファイル名を使用することをおすすめします。 ファイル名にタイムスタンプを含めます（例: 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;

  // The actions that can be performed using this deep link. At least one
  // Action must be specified.
  repeated Action actions = 1;
}

Action の定義

// Information about an Action which could be performed.
message Action {
  // Deprecated fields not to be reused.
  reserved 1;

  oneof action_info {
    AppointmentInfo appointment_info = 2;
  }
}

AppointmentInfo の定義

// Indicates that the parent Action is for booking an appointment.
// In v2 of the Action feed, the deep link URL is specified on ActionDetail.url,
// so this message has no fields and should be set as an empty object
// (for example, "appointment_info": {} in JSON).
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"

  ]
}