Método de entrega de inserción para los precios de hoteles

Si tienes limitaciones del sistema que te impiden admitir los métodos de entrega Pull o Pull con sugerencias, usa el formulario de contacto.

Descripción general del modo de entrega de inserción

Con el modo de entrega de envío, envías actualizaciones incrementales cada vez que cambian los precios o la disponibilidad.

En la siguiente imagen, se muestra el flujo de solicitud/respuesta del modo de entrega de envío:

Configuración de Push en el archivo de configuración del protocolo

Para actualizar los precios con el modo de entrega de envío, especifica los siguientes elementos en el archivo de configuración del protocolo. Solo debes hacer esto cuando configuras por primera vez tu entorno para trabajar con la API de Hotel Pricing:

  • <Model>: Establece el valor del elemento <Model> en "push".
  • <WhitelistedIPs>: Enumera tus direcciones IP que usas para autenticar la comunicación entre Google y tú. El valor de este elemento puede ser una lista separada por punto y coma de tus direcciones IP o un rango de direcciones IP con notación CIDR. Tiene el formato xxx.xxx.xxx.xxx/YY.

En el siguiente ejemplo, se muestra un archivo de configuración de protocolo para los socios que usan Push:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
  <Model>push</Model>
  <WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>

Para obtener más información, consulta Archivo de configuración del protocolo.

Actualiza los precios con Push

Para actualizar tus datos con envío, envía un mensaje de transacción cada vez que cambien tus datos.

Sigue estos lineamientos para enviar el mensaje de transacción:

  • Envía el mensaje al siguiente extremo:
    • http://www.google.com/travel/hotels/uploads/price
  • Usa el método HTTP POST.
  • Configura el encabezado Content-Type como "application/xml".
  • El cuerpo del mensaje debe cumplir con la sintaxis del mensaje de transacción, como se describe en Configura los precios (para las actualizaciones de precios) o Define los metadatos de paquetes y habitaciones (para las actualizaciones de metadatos).
  • En el caso de las actualizaciones de precios, define un elemento <Result> para cada itinerario que quieras actualizar. En el caso de las actualizaciones de metadatos, define los datos de paquetes y de habitaciones de cada propiedad que haya cambiado.

Por cada mensaje de transacción que reciba, Google responde con un mensaje HTTP 200 OK del servidor para indicar que se realizó correctamente. Si Google responde con un código de error de HTTP, vuelve a enviar el mensaje de transacción. Si tienes problemas para enviar o recibir mensajes, consulta Solución de problemas de feeds.

Debes enviar un mensaje de transacción para cada itinerario (combinación de propiedad, fecha de entrada y duración de la estadía) en el que haya cambiado el precio. Puedes enviar hasta 5 mensajes de transacción por segundo. Google no bloqueará los mensajes que se envíen con una frecuencia mayor que 5 por segundo, pero es posible que se agote el tiempo de espera del mensaje para que finalicen otras solicitudes.

Para reducir el tráfico de red, puedes combinar varios elementos <Result> en un solo mensaje de transacción.

Por lo general, Google procesa tus precios y datos de disponibilidad actualizados en unos 5 minutos. Los precios se borrarán después de 90 días.

Si quieres obtener más información sobre el uso de mensajes de transacción para actualizar los precios, consulta Configura los precios.

Cómo actualizar metadatos de Room y Package con Push

Para actualizar los metadatos de salas y paquetes, envía actualizaciones como lo harías con cualquier otra actualización. En este caso, envías un mensaje de transacción con la información nueva en los elementos <RoomData> y <PackageData>. Estos son elementos secundarios del elemento <PropertyDataSet>.

Para obtener más información, consulta Cómo definir los metadatos de Room y paquetes.

Errores del modo de entrega

Si recibes un error de HTTP cuando envías un mensaje de transacción a Google, vuelve a intentar la solicitud en intervalos de 1, 5 y 20 minutos. Si el problema persiste después de 3 reintentos, deja de enviar mensajes y comunícate con tu administrador de Cuentas de Google.

Cuando te comuniques con tu administrador de cuentas de Google para informar el error de HTTP que recibiste cuando enviaste un mensaje de transacción, Google ejecutará pruebas para aproximadamente 10 hoteles mientras trabaja contigo para verificar que tus feeds estén configurados de forma correcta. Si las pruebas son exitosas, Google rastreará el conjunto completo de hoteles especificado en tu feed de precios de hoteles. Esto garantiza que las cargas sean aceptables y que tus precios sigan siendo exactos durante 3 a 5 días. Después de esto, Google te notificará sobre el lanzamiento, en ese momento podrás consultar los resultados en vivo.

¿Con qué frecuencia se deben enviar los precios?

Lo ideal es que envíes todas las actualizaciones en cuanto sepas que cambió el precio. Si no sabes cuándo cambiaron los precios, intenta mantener los precios actualizados con la mayor frecuencia posible. Esto suele incluir varios envíos diarios. Por lo general, los itinerarios del día y la semana actuales se envían con mucha más frecuencia.