Method: accounts.properties.ingestLosPropertyPrices

Aktualisieren Sie die Preise für eine einzelne Unterkunft mithilfe der Formatierung von Preisen für die Aufenthaltsdauer. Bei einer bestimmten Unterkunft werden bei jedem Ankunftsdatum im angefragten Bereich alle Preise für Aufenthalte ersetzt, einschließlich aller Produkte und Belegungen. Preise mit Ankunftsdaten außerhalb der angegebenen Zeiträume sind davon nicht betroffen.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
propertyPrices.property

string

Der Ressourcenname des PropertyPrices. Hat das Format accounts/{account_id}/properties/{property_id}.

account_id: Dieser Stringwert ist die „Konto-ID“ Wert, der im Hotel Center auf der Seite „Kontoeinstellungen“ aufgeführt ist.

property_id: Der Wert dieses Elements muss ein String sein, der mit der Angebots-ID in Ihrem Hotellistenfeed übereinstimmt.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string (Timestamp format)

Erforderlich. Der Zeitpunkt, zu dem die Nachricht zum Preis der LoS gesendet wurde, ausgedrückt als String im RFC 3339-Format.

Alle Nachrichten, die in den letzten 24 Stunden mit einer requestTime gesendet wurden, werden verarbeitet und alle Nachrichten, die nicht gesendet wurden, werden verworfen.

Nachrichten werden in der Reihenfolge requestTime verarbeitet, in der sie eingegangen sind. Beispiel: Eine Preisaktualisierung mit dem Wert 2019-05-03T14:09:00Z für requestTime, die nach einer Nachricht für dieselben Reisepläne mit dem Wert 2019-05-03T14:10:00Z für requestTime empfangen wird, wird zugunsten der späteren Nachricht mit Zeitstempel verworfen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

Preise für ein Ankunftsdatum. Alle Preise in diesem arrivalDayPrices gelten für eine bestimmte Unterkunft, aber unterschiedliche Ankunftsdaten.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von PropertyPrices.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

LosPropertyPrices

Preise für die Aufenthaltsdauer, die auf Unterkunftsebene angegeben werden.

JSON-Darstellung 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
Felder
arrivalDatePrices[]

object (LosArrivalDatePrices)

Preise für ein Ankunftsdatum. Alle Preise in diesem arrivalDayPrices gelten für eine bestimmte Unterkunft, aber unterschiedliche Ankunftsdaten.
property

string

Der Ressourcenname des PropertyPrices. Hat das Format accounts/{account_id}/properties/{property_id}.

account_id: Dieser Stringwert ist die „Konto-ID“ Wert, der im Hotel Center auf der Seite „Kontoeinstellungen“ aufgeführt ist.

property_id: Der Wert dieses Elements muss ein String sein, der mit der Angebots-ID in Ihrem Hotellistenfeed übereinstimmt.

LosArrivalDatePrices

Preise für die Aufenthaltsdauer, gruppiert nach Ankunftszeiträumen.

JSON-Darstellung 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Felder
productPrices[]

object (LosProductPrices)

Die Preise für ein Produkt. Alle Preise in diesem productPrices gelten für eine bestimmte Kombination aus Unterkunft und Ankunftsdatum, aber für unterschiedliche Produkte.
startDate

object (Date)

productPrices wird auf alle Ankunftsdaten zwischen dem startDate und dem endDate angewendet.

Wenn Sie nur ein Ankunftsdatum (und keinen Datumsbereich) angeben möchten, kann endDate weggelassen werden.
endDate

object (Date)

productPrices wird auf alle Ankunftsdaten zwischen dem startDate und dem endDate angewendet.

Wenn Sie nur ein Ankunftsdatum (und keinen Datumsbereich) angeben möchten, kann endDate weggelassen werden.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
  • Ein Monat und ein Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
  • Ein Jahr für sich alleine, mit einem Monat und einem Tag von null.
  • Ein Jahr und ein Monat mit 0 Tag (z. B. dem Ablaufdatum einer Kreditkarte).

Ähnliche Typen:

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen oder 0, um ein Datum ohne Jahr anzugeben.
month

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben.
day

integer

Tag im Monat. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und Monat anzugeben, wenn der Tag nicht von Bedeutung ist.

LosProductPrices

Preise für die Aufenthaltsdauer, gruppiert nach Produkttyp (Kombinationen „roomTypeId/ratePlanId“).

JSON-Darstellung 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
Felder
occupancyPrices[]

object (LosOccupancyPrices)

Preise für Belegung. Alle Preise in diesem occupancyPrices gelten für eine bestimmte Unterkunft, ein Ankunftsdatum oder eine Produktkombination, aber für unterschiedliche Belegungen.
roomTypeId

string

Die eindeutige ID des Zimmers, auf das sich dieser Preis bezieht. Mit dieser ID ordnen Sie die Zimmerpaketdaten den von Ihnen gesendeten Zimmerdaten zu. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.

Wenn roomTypeId ausgefüllt ist, muss auch ratePlanId angegeben werden.
ratePlanId

string

Die eindeutige ID für die Paketdaten, auf die sich dieser Preis bezieht. Mit dieser ID ordnen Sie die Zimmerpaketdaten den Daten zu, die Sie in den Paketdaten gesendet haben. Weitere Informationen finden Sie unter Zimmerpaket-Metadaten.

Wenn ratePlanId ausgefüllt ist, muss auch roomTypeId angegeben werden.

LosOccupancyPrices

Preise für die Aufenthaltsdauer, gruppiert nach Belegung durch Erwachsene.

JSON-Darstellung 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
Felder
prices[]

object (LosPrices)

Preise für die Aufenthaltsdauer. Alle Preise im prices gelten für eine bestimmte Kombination aus Unterkunft, Ankunftsdatum, Produkt und Belegung.
adults

integer

Die maximale Anzahl von Gästen, die pro Zimmer gebucht werden können, einschließlich Erwachsene und Kinder. Dieser Wert wird für alle Preise im entsprechenden Feld „Belegungspreise“ festgelegt und muss eine positive Ganzzahl zwischen 1 und 99 sein.

LosPrices

Preise für die Aufenthaltsdauer.

JSON-Darstellung 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
Felder
rates[]

number

Die Basis-Rate-Komponente der Preise für die Aufenthaltsdauer.

Wenn ein entsprechender taxes-Wert angegeben wird, enthält dieser Preis keine Steuern. Der Gesamtpreis ergibt sich aus der Summe des relevanten Steuersatzes und der relevanten Steuern.

Sollte eine durch Kommas getrennte Liste von Preisen sein. Der Wert an Index n entspricht einer Aufenthaltsdauer von n+1.

Sie müssen den vollständigen LoS-Satz von 30 Preisen auf einmal senden. Wenn Sie weniger als 30 LoS senden, verarbeiten wir alle angegebenen Preise für die Aufenthaltsdauer wie gewohnt und die übrigen Preise als nicht verfügbar bis zu einem Betrag von 30 LOS. Wenn Sie mehr als 30 senden, senken wir alle Preise, die Sie über den 30. Preis hinaus senden.

Nicht verfügbare Aufenthaltsdauern sollten mit 0 dargestellt werden.
taxes[]

number

Die Steuerkomponente der Preise für die Aufenthaltsdauer.

Sollte eine durch Kommas getrennte Liste von Steuern sein. Der Wert an Index n entspricht einer Aufenthaltsdauer von n+1.
fees[]

number

Optional. Die Gebührenkomponente der Preise für die Aufenthaltsdauer.

Sollte eine durch Kommas getrennte Liste von Gebühren sein. Der Wert an Index n entspricht einer Aufenthaltsdauer von n+1.
rateRuleId

string

Bei nutzerabhängigen Preisen entspricht diese ID einem Preis einer Definition in Ihrer Datei zum Festlegen der Preisregel.

Die maximale Zeichenanzahl für dieses Feld beträgt 40 Zeichen.
currencyCode

string

Der dreistellige Währungscode, in dem Preise und Steuern angegeben sind. Beispiel: „USD“ für US-Dollar.

Gilt für rates und taxes.