Method: accounts.properties.ingestLosPropertyPrices

Actualiza los precios para una sola propiedad con los precios con formato de duración de la estadía. Para una propiedad determinada, se reemplazarán todos los precios de duración de la estadía en cada fecha de llegada del rango solicitado, incluidos todos los productos y las ocupaciones. Los precios con fechas de llegada fuera de los períodos especificados no se verán afectados.

Solicitud HTTP

POST https://travelpartnerprices.googleapis.com/v1/{propertyPrices.property=accounts/*/properties/*}:ingestLosPropertyPrices

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
propertyPrices.property

string

El nombre del recurso de PropertyPrices. Tiene el formato accounts/{account_id}/properties/{property_id}.

account_id: Este valor de cadena es el "ID de la cuenta". que aparece en la página Configuración de la cuenta de Hotel Center.

property_id: El valor de este elemento debe ser una cadena que coincida con el ID de la ficha de tu feed de lista de hoteles.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
Campos
requestTime

string (Timestamp format)

Obligatorio. El momento en el que se envió el mensaje de precio de LoS, expresado como una cadena con formato RFC 3339.

Se procesarán todos los mensajes que se envíen con una requestTime dentro de las 24 horas anteriores y se descartarán los que no lo hayan hecho.

Los mensajes se procesan en el orden de requestTime, independientemente del orden en que se reciban. Por ejemplo, una actualización de precio con un requestTime de 2019-05-03T14:09:00Z que se recibe después de un mensaje para los mismos itinerarios con un requestTime de 2019-05-03T14:10:00Z se descartará para dar lugar al mensaje con marca de tiempo posterior.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

Precios para una fecha de llegada. Todos los precios de este arrivalDayPrices se aplican a una propiedad específica, pero a diferentes fechas de llegada.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de PropertyPrices.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/travelpartner

Para obtener más información, consulta la descripción general de OAuth 2.0.

LosPropertyPrices

Precios de duración de la estadía, que se especifican a nivel de la propiedad

Representación JSON 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
Campos
arrivalDatePrices[]

object (LosArrivalDatePrices)

Precios para una fecha de llegada. Todos los precios de este arrivalDayPrices se aplican a una propiedad específica, pero a diferentes fechas de llegada.
property

string

El nombre del recurso de PropertyPrices. Tiene el formato accounts/{account_id}/properties/{property_id}.

account_id: Este valor de cadena es el "ID de la cuenta". que aparece en la página Configuración de la cuenta de Hotel Center.

property_id: El valor de este elemento debe ser una cadena que coincida con el ID de la ficha de tu feed de lista de hoteles.

LosArrivalDatePrices

Precios de duración de la estadía, agrupados por períodos de llegada.

Representación JSON 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Campos
productPrices[]

object (LosProductPrices)

Es el precio de un producto. Todos los precios en este productPrices se aplican a una propiedad específica, una combinación de fecha de llegada, pero a diferentes productos.
startDate

object (Date)

El productPrices se aplicará a todas las fechas de llegada entre el startDate y el endDate, inclusive.

Si solo intentas especificar una fecha de llegada (y no un rango), se puede omitir endDate.
endDate

object (Date)

El productPrices se aplicará a todas las fechas de llegada entre el startDate y el endDate, inclusive.

Si solo intentas especificar una fecha de llegada (y no un rango), se puede omitir endDate.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

  • Una fecha completa con valores para el año, mes y día que no sean cero.
  • Un mes y un día, con cero año (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo.

LosProductPrices

Precios por duración de la estadía, agrupados por tipo de producto (combinaciones RoomTypeId/ratePlanId).

Representación JSON 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
Campos
occupancyPrices[]

object (LosOccupancyPrices)

Precios por ocupación. Todos los precios de este occupancyPrices se aplican a una propiedad, fecha de llegada y combinación de productos específicas, pero a diferentes ocupaciones.
roomTypeId

string

Es el ID único de la habitación a la que hace referencia este precio. Usa este ID para hacer coincidir los datos del paquete de habitación con los que enviaste en esa información. Para obtener más información, consulta los metadatos del paquete de habitación.

Si se propaga roomTypeId, también se debe propagar ratePlanId.
ratePlanId

string

Es el ID único de los datos del paquete al que se refiere este precio. Usa este ID para hacer coincidir los datos del paquete de habitación con los que enviaste en packagedata. Para obtener más información, consulta los metadatos del paquete de habitación.

Si se propaga ratePlanId, también se debe propagar roomTypeId.

LosOccupancyPrices

Precios de duración de la estadía, agrupados por cantidad de ocupación para adultos

Representación JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
Campos
prices[]

object (LosPrices)

Precios por duración de la estadía Todos los precios en prices se aplican a una combinación específica de propiedad, fecha de llegada, producto y ocupación.
adults

integer

Indica la cantidad máxima de huéspedes que se pueden reservar por habitación, incluidos adultos y niños. Este valor se establece para todas las tarifas dentro del campo occupancyPrices correspondiente y debe ser un número entero positivo entre 1 y 99.

LosPrices

Precios por duración de la estadía

Representación JSON 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
Campos
rates[]

number

Componente de la tarifa base de los precios de la duración de la estadía

Si se proporciona un valor de taxes correspondiente, esta tarifa no incluye el impuesto (el precio total será la suma de los impuestos y la tarifa relevantes).

Debe ser una lista de tarifas separada por comas. El valor del índice n corresponde a una duración de la estadía de n+1.

Debes enviar el conjunto de LOS completo de 30 precios a la vez. Si envías menos de 30, procesaremos todos los precios de la LOS proporcionados como de costumbre, y las tarifas restantes como no disponibles hasta el límite de LoS 30. Si envías más de 30, reduciremos los precios que envíes a partir de esa tarifa.

Las duraciones de estadías no disponibles deben representarse con un 0.
taxes[]

number

Es el componente fiscal de los precios de duración de la estadía.

Los impuestos deben estar separados por comas. El valor del índice n corresponde a una duración de la estadía de n+1.
fees[]

number

Opcional. Es el componente de tarifa de los precios de duración de la estadía.

Debe ser una lista de tarifas separada por comas. El valor del índice n corresponde a una duración de la estadía de n+1.
rateRuleId

string

Para las tarifas condicionales, este ID hace coincidir una tarifa con una definición de tu archivo de definición de reglas de tarifas.

El límite de caracteres de este campo es de 40.
currencyCode

string

Es el código de moneda de tres letras en el que se proporcionan los impuestos y las tarifas. Por ejemplo, "USD" para dólares estadounidenses.

Se aplica a rates y taxes.