Feed de acciones

Crea y sube feeds de acciones

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

  • Sigue las especificaciones que se describen en el feed de acciones para los archivos de datos de acciones. Te recomendamos que uses nombres de archivo 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 del conjunto de archivos, establece el campo name en reservewithgoogle.action.v2. Para ver un ejemplo del archivo descriptor, consulta la muestra de JSON. Te recomendamos que uses nombres de archivo de descriptor ú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 Partner Portal.
  • Selecciona los servidores de feeds

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

Definiciones

Definición de ActionFeed

message ActionFeed {
  option features.(pb.java).nest_in_file_class = YES;

  repeated ActionDetail data = 1;
}

Definición de ActionDetail

message ActionDetail {
  option features.(pb.java).nest_in_file_class = YES;

  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 la acción

// Information about an Action which could be performed.
message Action {
  option features.(pb.java).nest_in_file_class = YES;

  // 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 {
  option features.(pb.java).nest_in_file_class = YES;

}

Muestras de feeds 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"

  ]
}