Method: accounts.properties.ingestLosPropertyPrices

Atualize os preços de uma única propriedade usando os preços formatados para a duração da estadia. Para uma determinada propriedade, todos os preços da estadia de cada data de chegada no intervalo solicitado serão substituídos, incluindo todos os produtos e ocupações. Os preços com datas de chegada fora dos períodos especificados não são afetados.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
propertyPrices.property

string

O nome de recurso do PropertyPrices. Tem o formato accounts/{account_id}/properties/{property_id}.

account_id: esse valor de string é o "ID da conta". listado na página "Configurações da conta" da Central para Hotéis.

property_id: o valor desse elemento precisa ser uma string que corresponda ao ID da ficha no seu feed de lista de hotéis.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
Campos
requestTime

string (Timestamp format)

Obrigatório. O momento em que a mensagem LoS Price foi enviada, expressa como uma string no formato RFC 3339.

Todas as mensagens enviadas com um requestTime nas últimas 24 horas serão processadas. As mensagens que não tiverem sido enviadas serão descartadas.

As mensagens são processadas em ordem de requestTime, independente da ordem em que são recebidas. Por exemplo, uma atualização de preço com um requestTime de 2019-05-03T14:09:00Z que é recebida depois de uma mensagem para os mesmos itinerários com um requestTime de 2019-05-03T14:10:00Z será descartada em favor da mensagem com carimbo de data/hora posterior.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

Preços para uma data de chegada. Todos os preços em arrivalDayPrices se aplicam a uma propriedade específica, mas com datas de chegada diferentes.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de PropertyPrices.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

LosPropertyPrices

Os preços de duração da estadia são especificados no nível da propriedade.

Representação JSON 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
Campos
arrivalDatePrices[]

object (LosArrivalDatePrices)

Preços para uma data de chegada. Todos os preços em arrivalDayPrices se aplicam a uma propriedade específica, mas com datas de chegada diferentes.
property

string

O nome de recurso do PropertyPrices. Tem o formato accounts/{account_id}/properties/{property_id}.

account_id: esse valor de string é o "ID da conta". listado na página "Configurações da conta" da Central para Hotéis.

property_id: o valor desse elemento precisa ser uma string que corresponda ao ID da ficha no seu feed de lista de hotéis.

LosArrivalDatePrices

Preços da duração da estadia, agrupados por períodos de chegada.

Representação JSON 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Campos
productPrices[]

object (LosProductPrices)

Preços de um produto. Todos os preços neste productPrices se aplicam a uma propriedade específica, combinação de datas de chegada, mas produtos diferentes.
startDate

object (Date)

O productPrices vai ser aplicado a todas as datas de chegada entre startDate e endDate.

Se você tentar especificar apenas uma data de chegada (e não um período), endDate poderá ser omitido.
endDate

object (Date)

O productPrices vai ser aplicado a todas as datas de chegada entre startDate e endDate, inclusive.

Se você tentar especificar apenas uma data de chegada (e não um período), endDate poderá ser omitido.

Data

Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é referente ao calendário gregoriano. Isso pode representar uma das seguintes opções:

  • uma data completa, com valores de ano, mês e dia diferentes de zero;
  • um mês e dia, com um ano zero (por exemplo, uma data comemorativa);
  • um ano sozinho, com um mês zero e um dia zero;
  • um ano e mês, com um dia zero (por exemplo, uma data de validade de cartão de crédito).

Tipos relacionados:

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

LosProductPrices

Preços de duração da estadia, agrupados por tipo de produto (combinações de roomTypeId/ratePlanId).

Representação JSON 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
Campos
occupancyPrices[]

object (LosOccupancyPrices)

Preços para uma ocupação. Todos os preços neste occupancyPrices se aplicam a uma propriedade, data de chegada e combinação de produtos específicas, mas a ocupações diferentes.
roomTypeId

string

O código exclusivo do quarto a que esse preço se refere. Use esse código para corresponder os dados de Categoria de quarto com o que você enviou nos dados de quarto. Para mais informações, consulte Metadados de Categoria de quarto.

Se roomTypeId estiver preenchido, ratePlanId também terá que estar.
ratePlanId

string

O ID exclusivo dos dados do pacote a que esse preço se refere. Use esse ID para corresponder os dados de Categoria de quarto com o que você enviou em packagedata. Para mais informações, consulte Metadados de Categoria de quarto.

Se ratePlanId estiver preenchido, roomTypeId também terá que estar.

LosOccupancyPrices

Preços para duração da estadia, agrupados por contagem de ocupação para adultos.

Representação JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
Campos
prices[]

object (LosPrices)

Preços por duração da estadia. Todos os preços em prices se aplicam a uma combinação específica de propriedade, data de chegada, produto e ocupação.
adults

integer

O número máximo de hóspedes que podem ser reservados por quarto, incluindo adultos e crianças. Esse valor é definido para todas as tarifas no campo "occupancyPrices" correspondente e precisa ser um número inteiro positivo entre 1 e 99.

LosPrices

Preços por duração da estadia.

Representação JSON 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
Campos
rates[]

number

O componente de tarifa básica dos preços de duração da estadia.

Se um valor de taxes correspondente for fornecido, essa taxa não incluirá os tributos (o preço total será a soma da taxa e dos tributos relevantes).

Precisa ser uma lista de tarifas separada por vírgulas. O valor no índice n corresponde a uma duração de estadia de n+1.

Você precisa enviar o conjunto completo de 30 preços de LoS de uma vez. Se você enviar menos de 30, vamos processar todos os preços de LoS fornecidos normalmente e as taxas restantes como indisponíveis até LoS 30. Se você enviar mais de 30, vamos reduzir os preços enviados além da 30a taxa.

As durações indisponíveis das estadias precisam ser representadas com 0.
taxes[]

number

O componente fiscal dos preços de duração da estadia.

Deve ser uma lista de tributos separada por vírgulas. O valor no índice n corresponde a uma duração de estadia de n+1.
fees[]

number

Opcional. O componente da tarifa de preços de duração da estadia.

Deve ser uma lista de taxas separada por vírgulas. O valor no índice n corresponde a uma duração de estadia de n+1.
rateRuleId

string

Para tarifas condicionais, esse ID faz a correspondência de uma taxa com uma definição no arquivo de definição da regra de tarifação.

O limite de caracteres desse campo é de 40 caracteres.
currencyCode

string

O código de moeda de três letras em que as taxas e os impostos são informados. Por exemplo, "USD" em dólares americanos.

Válido para rates e taxes.