Method: accounts.properties.ingestLosPropertyPrices

Aggiorna i prezzi di una singola struttura utilizzando i prezzi formattati in base alla durata del soggiorno. Per una determinata proprietà, per ogni data di arrivo nell'intervallo richiesto verranno sostituiti tutti i prezzi per la durata del soggiorno, inclusi tutti i prodotti e il numero di persone. I prezzi con date di arrivo al di fuori degli intervalli di date specificati non sono interessati.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
propertyPrices.property

string

Il nome della risorsa di PropertyPrices. Ha il formato accounts/{account_id}/properties/{property_id}.

account_id: questo valore di stringa è "ID account" indicato nella pagina Impostazioni account di Hotel Center.

property_id: il valore di questo elemento deve essere una stringa corrispondente all'ID scheda nel tuo feed elenco hotel.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
Campi
requestTime

string (Timestamp format)

Obbligatorio. Il momento in cui è stato inviato il messaggio relativo al prezzo LoS, espresso come stringa nel formato RFC 3339.

Tutti i messaggi inviati con requestTime nelle 24 ore precedenti verranno elaborati, mentre quelli non inviati verranno eliminati.

I messaggi vengono elaborati nell'ordine di requestTime, indipendentemente dall'ordine in cui sono stati ricevuti. Ad esempio, un aggiornamento dei prezzi con requestTime pari a 2019-05-03T14:09:00Z ricevuto dopo un messaggio per gli stessi itinerari con un valore requestTime pari a 2019-05-03T14:10:00Z verrà ignorato a favore del messaggio con timestamp successivo.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

Prezzi per una data di arrivo. Tutti i prezzi compresi in questo arrivalDayPrices si applicano a una struttura specifica, ma con date di arrivo diverse.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di PropertyPrices.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

LosPropertyPrices

Prezzi per la durata del soggiorno, specificati a livello di struttura.

Rappresentazione JSON 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
Campi
arrivalDatePrices[]

object (LosArrivalDatePrices)

Prezzi per una data di arrivo. Tutti i prezzi compresi in questo arrivalDayPrices si applicano a una struttura specifica, ma con date di arrivo diverse.
property

string

Il nome della risorsa di PropertyPrices. Ha il formato accounts/{account_id}/properties/{property_id}.

account_id: questo valore di stringa è "ID account" indicato nella pagina Impostazioni account di Hotel Center.

property_id: il valore di questo elemento deve essere una stringa corrispondente all'ID scheda nel tuo feed elenco hotel.

LosArrivalDatePrices

Prezzi della durata del soggiorno, raggruppati per intervalli di date di arrivo.

Rappresentazione JSON 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Campi
productPrices[]

object (LosProductPrices)

Prezzi di un prodotto. Tutti i prezzi all'interno di questo productPrices si applicano a una proprietà specifica, a una combinazione di data di arrivo, ma a prodotti diversi.
startDate

object (Date)

L'productPrices verrà applicato a tutte le date di arrivo comprese tra il giorno startDate e il giorno endDate.

Se provi a specificare una sola data di arrivo (e non un intervallo), endDate potrebbe essere omesso.
endDate

object (Date)

L'productPrices verrà applicato a tutte le date di arrivo comprese tra il giorno startDate e il giorno endDate.

Se provi a specificare una sola data di arrivo (e non un intervallo), endDate potrebbe essere omesso.

Data

Rappresenta una data di calendario intera o parziale, come un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può trattarsi di uno dei seguenti valori:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno con zero anni (ad esempio, un anniversario).
  • Un anno a sé stante, con uno zero mese e uno zero-day.
  • Un anno e un mese, con zero day (ad esempio, la data di scadenza della carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese dell'anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo.

LosProductPrices

Prezzi per la durata del soggiorno, raggruppati per tipo di prodotto (combinazioni roomTypeId/ratePlanId).

Rappresentazione JSON 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
Campi
occupancyPrices[]

object (LosOccupancyPrices)

Prezzi per un numero di persone. Tutti i prezzi all'interno di questo occupancyPrices si applicano a una struttura, a una data di arrivo e a una combinazione di prodotti specifici, ma per numero di persone diversi.
roomTypeId

string

L'ID univoco della camera a cui fa riferimento questo prezzo. Utilizza questo ID per associare i dati del pacchetto camera a quelli che hai inviato nei dati della camera. Per ulteriori informazioni, consulta la sezione Metadati dei pacchetti camera.

Se roomTypeId è compilato, deve essere compilato anche ratePlanId.
ratePlanId

string

L'ID univoco dei dati del pacchetto a cui fa riferimento questo prezzo. Utilizza questo ID per associare i dati del pacchetto camera a quelli che hai inviato nei dati del pacchetto. Per ulteriori informazioni, consulta la sezione Metadati dei pacchetti camera.

Se ratePlanId è compilato, deve essere compilato anche roomTypeId.

LosOccupancyPrices

Prezzi della durata del soggiorno, raggruppati per numero di adulti.

Rappresentazione JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
Campi
prices[]

object (LosPrices)

Prezzi per la durata del soggiorno. Tutti i prezzi all'interno di prices si applicano a una specifica combinazione di proprietà, data di arrivo, prodotto e numero di persone.
adults

integer

Il numero massimo di ospiti prenotabili per camera, inclusi adulti e bambini. Questo valore è impostato per tutte le tariffe all'interno del campo occupancyPrices corrispondente e deve essere un numero intero positivo compreso tra 1 e 99.

LosPrices

Prezzi per la durata del soggiorno.

Rappresentazione JSON 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
Campi
rates[]

number

Il componente della tariffa di base dei prezzi della durata del soggiorno.

Se viene fornito un valore taxes corrispondente, questa aliquota non è comprensiva dell'imposta (il prezzo totale sarà pari alla somma dell'aliquota e delle imposte pertinenti).

Deve essere un elenco di tariffe separate da virgole. Il valore all'indice n corrisponde a una durata del soggiorno di n+1.

Devi inviare l'intero set di 30 prezzi relativi alla LoS alla volta. Se ne invii meno di 30, elaboreremo tutti i prezzi della LoS forniti come di consueto, mentre le tariffe rimanenti non saranno disponibili fino a un massimo di 30 LoS. Se ne invii più di 30, abbandoneremo la tariffa che supera la 30a tariffa.

Le durate dei soggiorni non disponibili devono essere rappresentate con un 0.
taxes[]

number

La componente fiscale dei prezzi della durata del soggiorno.

Deve essere un elenco di imposte separato da virgole. Il valore all'indice n corrisponde a una durata del soggiorno di n+1.
fees[]

number

(Facoltativo) La componente della tariffa dei prezzi della durata del soggiorno.

Deve essere un elenco di tariffe separate da virgole. Il valore all'indice n corrisponde a una durata del soggiorno di n+1.
rateRuleId

string

Per le tariffe agevolate, questo ID associa una tariffa a una definizione nel file di definizione delle regole tariffarie.

Il limite di caratteri per questo campo è 40.
currencyCode

string

Il codice valuta di tre lettere in cui sono indicate tariffe e imposte. Ad esempio, "USD" per i dollari statunitensi.

Si applica a rates e taxes.