Method: accounts.properties.ingestLosPropertyPrices

Modifiez les prix d'un seul établissement en utilisant le format de prix correspondant à la durée du séjour. Pour un établissement donné, tous les prix de séjour de chaque date d'arrivée dans la plage demandée seront remplacés, y compris les produits et le nombre de personnes. Les prix dont les dates d'arrivée sont en dehors des périodes spécifiées ne sont pas affectés.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
propertyPrices.property

string

Nom de ressource de PropertyPrices. Format : accounts/{account_id}/properties/{property_id}.

account_id: cette valeur de chaîne correspond à l'ID du compte. sur la page "Paramètres du compte" dans Hotel Center.

property_id: la valeur de cet élément doit être une chaîne correspondant à l'ID de fiche de votre flux Hotel List Feed.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
Champs
requestTime

string (Timestamp format)

Obligatoire. Moment auquel le message de prix LoS a été envoyé, exprimé sous la forme d'une chaîne au format RFC 3339.

Tous les messages envoyés avec l'attribut requestTime au cours des dernières 24 heures seront traités, et ceux qui ne l'ont pas été seront supprimés.

Les messages sont traités par ordre de requestTime, quel que soit l'ordre de réception. Par exemple, une mise à jour de prix avec un requestTime de 2019-05-03T14:09:00Z reçue après un message pour les mêmes itinéraires dont l'requestTime est 2019-05-03T14:10:00Z sera supprimée et remplacée par le message horodaté plus tard.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

Prix pour une date d'arrivée. Tous les prix de cette arrivalDayPrices s'appliquent à un établissement spécifique, mais avec des dates d'arrivée différentes.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de PropertyPrices.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

LosPropertyPrices

Prix de la durée du séjour, spécifiés au niveau de l'établissement.

Représentation JSON 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
Champs
arrivalDatePrices[]

object (LosArrivalDatePrices)

Prix pour une date d'arrivée. Tous les prix de cette arrivalDayPrices s'appliquent à un établissement spécifique, mais avec des dates d'arrivée différentes.
property

string

Nom de ressource de PropertyPrices. Format : accounts/{account_id}/properties/{property_id}.

account_id: cette valeur de chaîne correspond à l'ID du compte. sur la page "Paramètres du compte" dans Hotel Center.

property_id: la valeur de cet élément doit être une chaîne correspondant à l'ID de fiche de votre flux Hotel List Feed.

LosArrivalDatePrices

Prix de la durée du séjour, regroupés par plages de dates d'arrivée.

Représentation JSON 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Champs
productPrices[]

object (LosProductPrices)

Prix d'un produit. Tous les prix de ce productPrices s'appliquent à un établissement et à une combinaison de dates d'arrivée spécifiques, mais à des produits différents.
startDate

object (Date)

Le productPrices s'appliquera à toutes les dates d'arrivée comprises entre le startDate et le endDate (inclus).

Si vous essayez de spécifier une seule date d'arrivée (et non une période), endDate peut être omis.
endDate

object (Date)

Le productPrices s'appliquera à toutes les dates d'arrivée comprises entre le startDate et le endDate (inclus).

Si vous essayez de spécifier une seule date d'arrivée (et non une période), endDate peut être omis.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Il peut s'agir de l'un des éléments suivants:

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • une année seule, avec un mois et un jour zéro.
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés:

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année.
month

integer

Mois de l'année. La valeur doit être comprise entre 1 et 12, ou égale à 0 pour spécifier une année sans mois ni jour.
day

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.

LosProductPrices

Prix de la durée du séjour, regroupés par type de produit (combinaisons chambresTypeId/ratePlanId).

Représentation JSON 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
Champs
occupancyPrices[]

object (LosOccupancyPrices)

Prix par nombre de personnes. Tous les prix de ce occupancyPrices s'appliquent à un établissement, une date d'arrivée et une combinaison de produits spécifiques, mais pour un nombre de personnes différent.
roomTypeId

string

Identifiant unique de la chambre à laquelle ce prix fait référence. Utilisez cet identifiant pour faire correspondre les données de l'offre de chambres avec celles que vous avez envoyées dans roomdata. Pour en savoir plus, consultez Métadonnées des offres de chambres.

Si roomTypeId est renseigné, ratePlanId doit également être renseigné.
ratePlanId

string

Identifiant unique des données de séjour organisé à laquelle ce prix fait référence. Utilisez cet identifiant pour faire correspondre les données de l'offre de chambres avec celles que vous avez envoyées dans les données du package. Pour en savoir plus, consultez Métadonnées des offres de chambres.

Si ratePlanId est renseigné, roomTypeId doit également être renseigné.

LosOccupancyPrices

Prix de la durée du séjour, regroupés par nombre d'adultes.

Représentation JSON 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
Champs
prices[]

object (LosPrices)

Prix selon la durée du séjour. Tous les prix dans les prices s'appliquent à un établissement, une date d'arrivée, un produit et un nombre de personnes spécifiques.
adults

integer

Nombre maximal de personnes pouvant être réservées par chambre, adultes et enfants compris. Cette valeur est définie pour tous les tarifs dans le champ occupancyPrices correspondant. Elle doit être un entier positif compris entre 1 et 99.

LosPrices

Prix selon la durée du séjour.

Représentation JSON 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
Champs
rates[]

number

Composante "Tarif de base" des prix liés à la durée du séjour.

Si une valeur taxes correspondante est fournie, ce taux n'inclut pas les taxes (le prix total correspond à la somme du tarif et des taxes applicables).

Doit se présenter sous la forme d'une liste de tarifs séparés par une virgule. La valeur à l'indice n correspond à une durée de séjour de n+1.

Vous devez envoyer simultanément l'ensemble complet de 30 prix pour la DDS. Si vous en envoyez moins de 30, nous traiterons comme d'habitude tous les prix pour la DDS fournis. Les autres tarifs seront considérés comme indisponibles jusqu'à 30 LOS. Si vous en envoyez plus de 30, nous abandonnerons tous les prix que vous envoyez au-delà du 30e tarif.

Les durées de séjour non disponibles doivent être représentées par un 0.
taxes[]

number

Composante "taxes" des prix selon la durée du séjour.

Indiquez une liste de taxes séparées par une virgule. La valeur à l'indice n correspond à une durée de séjour de n+1.
fees[]

number

Facultatif. Composante "frais" dans le prix de la durée du séjour.

Doit se présenter sous la forme d'une liste de frais séparés par une virgule. La valeur à l'indice n correspond à une durée de séjour de n+1.
rateRuleId

string

Pour les tarifs sous conditions, cet identifiant fait correspondre un tarif à une définition dans votre fichier de définition des règles d'offres.

Le nombre maximal de caractères pour ce champ est de 40.
currencyCode

string

Code à trois lettres de la devise dans laquelle les tarifs et les taxes sont fournis. Exemple : "EUR" pour le dollar américain.

S'applique à rates et taxes.