Feed de acciones

Cómo crear y subir feeds de acciones

Cuando crees y subas feeds de acciones, sigue estas instrucciones:

  • Sigue la especificación que se describe en el feed de acciones para los archivos de datos de acciones. Te recomendamos que uses nombres de archivos de datos de acciones únicos para cada carga. Incluye una marca de tiempo en el nombre del archivo, por ejemplo, action_1633621547.json.
  • En el descriptor de conjunto de archivos, establece el name campo en reservewithgoogle.action.v2. Para ver un ejemplo del archivo descriptor, consulta la muestra de JSON. Te recomendamos que uses nombres de archivos descriptores únicos para cada carga. Incluye una marca de tiempo en el nombre del archivo, por ejemplo, action_1633621547.filesetdesc.json. El archivo descriptor se debe subir al servidor SFTP genérico.
  • Sube feeds al servidor SFTP genérico todos los días como actualizaciones completas.
  • Puedes encontrar los detalles del servidor SFTP en la sección Configuración > Feeds del Portal para socios.

    • Selecciona servidores de feeds

    Selección de servidores de feeds en el Portal para socios
  • Consulta el estado de la transferencia de feeds en la sección Feeds > Historial del Portal para socios.

Definiciones

Definición de ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definición de 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;
}

Definición de 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;
  }
}

Definición de 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 {
}

Muestras de feed de acciones

Feed de acciones

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

Archivo descriptor

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

  ]
}