Action feed

AI-generated Key Takeaways

• When creating and uploading action feeds, follow the specified format and use unique, timestamped filenames for data and descriptor files.

• Set the name field in the fileset descriptor to reservewithgoogle.action.v2.

• Upload feeds daily as full refreshes to the generic SFTP server found in the Partner Portal Configuration section.

• Monitor feed ingestion status in the Feeds > History section of the Partner Portal.

• The Action feed spec is defined in protobuffer format but uploading in JSON format is recommended.

Note: For integration utilizing the legacy version of the Action feed, review the legacy feed reference. If you are unsure which version of the feed has been enabled for your integration, reach out to your Google contact.

Create and upload action feeds

When creating and uploading action feeds, follow these instructions:

• Follow the spec described in the action feed for action data files. We recommend using unique action data file names for each upload. Include a timestamp in the filename, for example, action_1633621547.json.
• In the fileset descriptor, set the name field to reservewithgoogle.action.v2. For an example of the descriptor file, refer to the JSON sample. We recommend using unique descriptor file names for each upload. Include a timestamp in the filename, for example, action_1633621547.filesetdesc.json. The descriptor file must be uploaded to the generic SFTP server.
• Upload feeds to the generic SFTP server daily as full refreshes.
• You can find SFTP server details in the Configuration > Feeds section of the Partner Portal.



Selecting feed servers in the Partner Portal

• View feed ingestion status in the Feeds > History section of the Partner Portal.

Definitions

Note: The Action feed spec is defined in protobuffer format below, however we recommend uploading the feeds in JSON format. You can reference our JSON sample feeds for more information.

ActionFeed Definition

message ActionFeed {
  repeated ActionDetail data = 1;
}

ActionDetail Definition

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

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

AppointmentInfo Definition

message AppointmentInfo {
}

Action Feed samples

Action Feed

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

Descriptor File

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

  ]
}