Message Transaction (Données sur un établissement)

Présentation

Le message de transaction ARI (Property Data) définit les informations concernant chaque les types de chambres et les formules (ou plans tarifaires) de l'établissement. Chaque type de chambre comprend un identifiant unique (RoomID), un nom localisé, une description et des URL vers des photos de la chambre. Les données de chaque package comprennent un identifiant unique (PackageID), localisé le nom, la description, le nombre de personnes et les valeurs ajoutées.

Vous pouvez utiliser un message Transaction pour:

• Définissez des données pour une ou plusieurs propriétés.
• Définissez les informations sur le type de chambre et la formule pour chaque établissement.
• Contrôler les offres de produits

Vous pouvez également définir des actions pour:

• Ajoutez un type de chambre et une formule à un établissement.

  Important :Le type de chambre est limité à 3 000 par établissement. Les packages ont également un une limite distincte de 3 000 par propriété. Vous pouvez utiliser le message <Transaction> pour supprimer des types de chambres ou des packages.

• Supprimez un type de chambre et une formule d'un établissement.

Pour obtenir des exemples de messages Transaction, consultez l'article Transaction (Données sur un établissement) Exemples.

Éléments obligatoires et facultatifs

La documentation de référence XML fournit une description des éléments obligatoires et facultatifs. Pour en savoir plus sur et les éléments enfants, consultez la section Éléments de transaction (données sur un établissement) et Attributs :

Syntaxe et schémas

Utilisez le rapport Transaction (Données sur un établissement) Syntaxe comme référence lorsque vous créez le message Transaction. vous suivez le bon format.

Vous pouvez utiliser un outil XML tiers tel que xmllint pour valider vos flux avec les schémas publiés avant de les envoyer à Google. Pour la transaction de message, consultez la page Hotel Ads de données.

Consignes

Suivez les consignes ci-dessous pour les messages Transaction:

Actions :

delta: permet d'ajouter ou de mettre à jour de nouveaux types de chambres et de formules (plans tarifaires).

overlay : permet de remplacer tous les types de chambres et les packages d'un établissement par un nouvel ensemble. doit inclure des informations sur tous les types de chambres et tous les plans tarifaires qui : que vous souhaitez toujours vendre.

Langues acceptées:

Indiquez une à deux langues (anglais et une langue locale pour l'établissement, si nécessaire) pour les champs "Nom", "Description" et "Libellé". Vous pouvez en ajouter d'autres de deux langues si nécessaire.

Types de chambres et formules:

Lorsque vous modifiez un type de chambre ou une formule, vous devez envoyer tous les des informations sur le type de chambre ou la formule. Par exemple, lorsque vous ajoutez une photo, vous devez également inclure le nom et la description.

<AllowablePackageIDs> et <AllowableRoomIDs> sont facultatifs. Si ces paramètres ne sont pas définis, vous pouvez créer n'importe quelle combinaison de type de chambre et de plan tarifaire. Il vous reste à envoyer la disponibilité et les tarifs avec les identifiants du type de chambre et du plan tarifaire. Ces vous permettent de contrôler les produits et de désactiver les combinaisons n'est plus pris en charge.

Envoyer à Google un message Transaction actualisé en cas de changement de chambre des types de chambres ou de formules, ou des détails importants sur les types de chambres ou de formules qui doivent être ajoutées.

Remarque :Google stocke les données d'établissements associées à une correspondance , Google ne peut accepter ces données qu'une fois que la propriété correspondante a été "correspondance" dans le système. Envoyer tous vos établissements dans votre flux de liste pour éviter des erreurs ou des retards ultérieurs.

Exemple

Cette section fournit un exemple basique de message Transaction ARI utilisant obligatoires et facultatifs. Pour ajouter ou mettre à jour des types de chambres et des formules, vous devez Utilisez une action pour delta afin d'ajouter ou de mettre à jour les types de chambres et les formules. overlay pour remplacer toutes les définitions de type de chambre et de formule (supprime les anciennes ).

Vous devez indiquer une ou deux langues (l'anglais et une langue locale pour si nécessaire) dans les champs "Nom", "Description" et "Sous-titre". Ajoutez ensuite les informations sur l'établissement, y compris des liens vers des photos.

Pour <PropertyID> et <RoomID>, utilisez les mêmes ID que dans votre système. pour les plans tarifaires et les types de chambres (respectivement). La cohérence avec votre système est essentielle pour garantir que Google affiche correctement vos prix et vos données.

Remarque :Google utilise le terme "ID". pour l'identifiant du type de chambre et de la formule (plan tarifaire) ; tandis que le format XML OTA utilise le "code". Vous devez utiliser vos propres ID, car Google n'utilise pas les générer. Pour les données de l'établissement, les identifiants du type de chambre et des plans tarifaires doivent être uniques par propriété.

Une fois votre fichier préparé, vous devez l'envoyer à Google via un message POST. au point de terminaison suivant: https://www.google.com/travel/hotels/uploads/property_data

Pour en savoir plus sur la méthode Push/POST du message, consultez la section Push messages.

L'exemple suivant montre comment définir le message Transaction à l'aide d'un élément delta. action:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

Pour obtenir d'autres exemples, par exemple sur l'utilisation de l'action overlay, l'ajout d'un type de chambre et d'une formule aux données d'un établissement existant, et la suppression de types de chambres et de formules existants, consultez la section Exemples de messages Transaction (Données sur un établissement).

Guides pratiques

Cette section fournit des solutions aux scénarios que vous pouvez rencontrer l'envoi de messages Transaction.

Scénario 1: Supprimer les données relatives au type de chambre

Comment supprimer des données de type de chambre et/ou de formule existantes ?

Description

Vous avez envoyé plusieurs types de chambres, y compris des chambres très spacieuses pour la grande taille et la grande taille d'hôtel, pour la . Tous les types de chambres "grand lit" ne sont pas disponibles en période de rénovation et ne sont disponibles qu'en chambre "King" types de chambres sont actuellement disponibles.

Solution

• Vous n'avez pas besoin de mettre à jour la disponibilité, les tarifs ou l'inventaire par nuit pour le type de chambre et les identifiants des séjours organisés qui ont été supprimés ou désactivés ;
• Si le type de chambre ou la formule ont été supprimés ou désactivés, envoyez un nouveau Message Transaction avec action="overlay" qui inclut uniquement la chambre types et formules toujours actifs, à l'exception du type de chambre supprimé ou un package.

Échantillon

Cet extrait XML montre comment utiliser l'action overlay pour supprimer un type de chambre.

Remarque : Même si cet exemple concerne le type de chambre, vous pouvez également utiliser la même action pour supprimer les données de l'offre.

Voici l'action delta d'origine, qui inclut les types de chambre "King" et "Queen" :

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

Vous pourrez ensuite configurer overlay de manière à supprimer le type de chambre "Queen" et à conserver le roi type de chambre:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

Scénario 2: Contrôler les produits à l'aide de AllowablePackageID

Comment contrôler des produits (combinaisons de types de chambres et de formules) lorsque les formules sont regroupées par type de chambre ?

Remarque :Si vos types de chambres sont regroupés par formule, consultez le Scénario 3.

Description

Certaines formules ne sont disponibles que pour certains types de chambres. Pour Par exemple, si votre établissement propose quatre types de chambres (dont la suite présidentielle), et six packages différents, mais seuls quelques packages sont éligibles présidentielle, vous pouvez spécifier son éligibilité.

Solution

Envoyer un message Transaction mis à jour indiquant les produits inclus du package à l'aide de <AllowablePackageIDs>.

Remarque :Utilisez <AllowablePackageIDs> ou <AllowableRoomIDs>, mais pas les deux. L'élément que vous utilisez varie selon que votre système utilise ou non la hiérarchie chambre > formule ou séjour organisé > chambre. Si aucun de ces éléments n'est défini dans le Message Transaction indiquant que le type de chambre peut être associé à n'importe quelle formule.

Échantillon

Cet extrait de code XML montre comment utiliser <AllowablePackageIDs> pour spécifier les packages utilisés avec un certain type de chambre. Ici, le type de chambre "Suite Penthouse" n'autorise que le forfait tout compris Penthouse ou le forfait petit-déjeuner gratuit, tandis que le type de chambre "Suite King" n'autorise que le forfait tout compris King ou le forfait animaux acceptés.

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

Remarque: Si vous utilisez <AllowablePackageIDs> ou <AllowableRoomIDs> pour désactiver une combinaison que vous avez peut-être utilisée précédemment, mais qui est désormais interdite dans votre vous n'avez pas besoin de renvoyer les flux ARI pour toutes les dates, simplement pour supprimer données.

Scénario 3 : Contrôler des produits à l'aide de AllowableRoomIDs

Comment contrôler des produits (combinaisons de types de chambres et de formules) lorsque les types de chambres sont regroupés par formule ?

Remarque :Si vos formules sont regroupées par type de chambre, consultez le Scénario 2.

Description

Une combinaison type de chambre/formule n'est plus vendue comme un produit, ou vous souhaitez pour contrôler ce qui est inclus dans un nouveau package. Par exemple, vous pouvez spécifier que certains types de chambres, tels que les chambres royales ou Queen Lens avec vue sur l'océan, un package.

Solution

Envoyer un message Transaction mis à jour indiquant les produits exacts inclus avec le package à l'aide de l'élément <AllowableRoomIDs>.

Échantillon

Cet extrait de code XML montre comment utiliser <AllowableRoomID> pour spécifier Oceanview King et les chambres Queen grandes dans la formule.

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>