Messaggio Transaction (Property Data)

Panoramica

Il messaggio ARI Transaction (Property Data) definisce le informazioni sui tipi di camera e sui pacchetti (o piani tariffari) di ogni proprietà. I dati di ogni tipo di camera includono un identificatore univoco (RoomID), il nome localizzato, la descrizione e gli URL delle foto delle camere. I dati di ogni pacchetto includono un identificatore univoco (PackageID), localizzato nome, descrizione, numero di persone e valore aggiunto.

Puoi utilizzare un messaggio Transaction per:

• Definisci i dati per una o più proprietà.
• Definisci le informazioni sul tipo di camera e sul pacchetto per ogni proprietà.
• Controllare le offerte dei prodotti.

Inoltre, puoi impostare azioni per:

• Aggiungi un tipo di camera e un pacchetto a una proprietà.

  Punto chiave: il tipo di camera ha un limite di 3000 per proprietà. Inoltre, Packages ha un un limite separato di 3000 per proprietà. Puoi usare <Transaction> messaggio per rimuovere pacchetti o tipi di camere.

• Rimuovere un tipo di camera e un pacchetto da una proprietà.

Per esempi di messaggi di transazione, consulta Transaction (Property Data) Esempi.

Elementi obbligatori e facoltativi

Il riferimento XML fornisce le descrizioni degli elementi obbligatori e facoltativi. Per maggiori dettagli su ed elementi secondari, consulta Elementi ed elementi di Transaction (Property Data) Attributi.

Sintassi e schemi

Utilizza Transaction (Property Data) Sintassi esempio come riferimento quando crei il messaggio Transaction per assicurarti stai seguendo il formato corretto.

Puoi utilizzare uno strumento XML di terze parti come xmllint per convalidare i tuoi feed con gli schemi pubblicati prima di inviarli a Google. Per la transazione consulta lo schema dei messaggi, consulta Hotel Ads .

Linee guida

Segui queste linee guida per un messaggio Transaction:

Azioni:

delta: consente di aggiungere o aggiornare nuovi tipi di camera e pacchetti (piani tariffari).

overlay: consente di sostituire tutti i pacchetti e i tipi di camera di una proprietà con un nuovo set. Devi includere informazioni su tutti i tipi di camera e i piani tariffari che che vuoi ancora vendere.

Lingue supportate:

Specifica da una a due lingue (inglese e una lingua locale per la struttura) se necessario) per i campi Nome, Descrizione e Didascalia. Puoi aggiungerne altri più di due lingue, se necessario.

Tipi di camere e pacchetti:

Quando aggiorni un tipo di camera o un pacchetto, devi inviare tutti i relativi le informazioni per quel tipo di camera o pacchetto. Ad esempio, quando aggiungi un foto devi includere anche il nome e la descrizione.

<AllowablePackageIDs> e <AllowableRoomIDs> sono facoltativi e, se non vengono impostati, è possibile creare qualsiasi combinazione di tipo di camera e piano tariffario. Devi ancora invia disponibilità e tariffe con gli ID del tipo di camera e del piano tariffario. Questi elementi ti consentono di controllare i prodotti e di disattivare le combinazioni non più supportate dal tuo sistema.

Invia a Google un aggiornamento del messaggio Transaction ogni volta che viene apportata una modifica alla stanza tipi o pacchetti oppure dettagli importanti su tipi di camera o pacchetti che devono essere aggiunti.

di Gemini Advanced.

.

Nota: poiché Google memorizza i dati di proprietà collegati a una "corrispondenza" proprietà, Google può accettare questi dati solo dopo che la proprietà corrispondente non è stata "corrispondente" nel sistema. L'invio di tutte le proprietà nel tuo feed elenco può per evitare errori o ritardi successivi.

Esempio

Questa sezione fornisce un esempio base di messaggio Transaction ARI che utilizza elementi obbligatori e facoltativi. Per aggiungere o aggiornare tipi di camera e pacchetti: utilizzare un'azione per delta per aggiungere o aggiornare tipi di camera e pacchetti oppure overlay per sostituire tutti i tipi di camera e le definizioni di pacchetto (elimina i vecchi dati ).

Devi specificare una o due lingue (inglese e una lingua locale per il , se necessario) per i campi Nome, Descrizione e Didascalia. Poi aggiungi informazioni sui dati della proprietà, tra cui i link alle foto.

Per <PropertyID> e <RoomID>, utilizza gli stessi ID del sistema per i piani tariffari e i tipi di camera (rispettivamente). La coerenza con il sistema è fondamentale per garantire che Google mostri correttamente prezzi e dati.

Nota: Google utilizza "ID" per l'identificatore del tipo di camera e del pacchetto (piano tariffario), mentre il file XML OTA utilizza "code". Devi usare i tuoi ID poiché Google non generarle. Per i dati della struttura, gli ID del tipo di camera e del piano tariffario devono essere univoci per proprietà.

Dopo aver preparato il file, devi inviarlo a Google tramite un messaggio POST al seguente endpoint: https://www.google.com/travel/hotels/uploads/property_data

Per scoprire di più su come eseguire il push/POST del messaggio, consulta Pushing messaggi.

L'esempio seguente mostra come impostare il messaggio Transaction utilizzando un delta azione:

<?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>

Per altri esempi, ad esempio su come utilizzare l'azione overlay, aggiungi un tipo di stanza e pacchettizzare i dati della struttura esistenti e rimuovere i tipi di camera e pacchetti, consulta Transaction (Property Data) Esempi.

Procedure

Questa sezione fornisce soluzioni per gli scenari che potresti riscontrare durante l'invio di messaggi Transaction.

Scenario 1: come rimuovere i dati relativi al tipo di camera

Come faccio a rimuovere i dati esistenti del tipo di camera e/o del pacchetto?

Descrizione

Hai inviato più tipi di camere, tra cui camere matrimoniali e queen, per la proprietà. Durante la ristrutturazione, tutte le camere queen non sono disponibili. Solo letti king size tipi di camere sono attualmente disponibili.

Soluzione

• Non è necessario aggiornare la disponibilità, le tariffe o l'inventario per notte il tipo di camera e gli ID pacchetto rimossi o disattivati.
• Se il tipo di camera o il pacchetto è stato rimosso o disattivato, invia un nuovo messaggio Transaction con action="overlay" che includa solo i tipi di camera e i pacchetti ancora attivi ed escluda il tipo di camera o il pacchetto rimosso.

Esempio

Questo snippet XML mostra come utilizzare l'azione overlay per rimuovere un tipo di camera.

Nota: anche se questo esempio copre il tipo di camera, puoi anche utilizzare lo stesso per rimuovere i dati del pacchetto.

Ecco l'azione originale di delta, che include le tipologie di camera King e 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>

Puoi quindi impostare overlay in modo da rimuovere il tipo di camera Queen e mantenere la camera Regina tipo di stanza:

  <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>

Scenario 2: come controllare i prodotti utilizzando allowablePackageIDs

Come posso controllare i prodotti (combinazioni di tipi di camera e pacchetti) quando i pacchetti sono raggruppati per tipo di camera?

Nota: se i tipi di camera sono raggruppati per pacchetti, consulta lo Scenario 3.

Descrizione

Alcuni pacchetti sono disponibili solo per determinati tipi di camere. Per Ad esempio, se la proprietà ha quattro tipi di camera (inclusa la suite presidenziale), e sei pacchetti diversi, ma solo alcuni sono idonei suite presidenziale, puoi specificare l'idoneità.

Soluzione

Invia un messaggio Transaction aggiornato che specifichi quali prodotti sono inclusi nel pacchetto utilizzando <AllowablePackageIDs>.

Nota: usa <AllowablePackageIDs> o <AllowableRoomIDs>, ma non entrambi e l'elemento che utilizzi dipende dall'uso o meno della gerarchia nel sistema camera>pacchetti o pacchetti>camera. Se nessuno di questi elementi è definito nel Messaggio Transaction: i tipi di camera possono essere combinati con qualsiasi pacchetto.

Esempio

Questo snippet XML mostra come utilizzare <AllowablePackageIDs> per specificare i pacchetti utilizzata con un determinato tipo di camera. Qui, la tipologia di camera Attico permette solo il pacchetto all-inclusive Penthouse o il pacchetto colazione inclusa, mentre La tipologia di camera King Standard accetta solo il pacchetto King all-inclusive o Pacchetto che accetta animali domestici.

<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>

Nota: se utilizzi <AllowablePackageIDs> o <AllowableRoomIDs> per disattivare una combinazione che potresti aver utilizzato in precedenza, ma che ora non è consentita nel tuo sistema, non è necessario inviare nuovamente l'ARI per tutte le date solo per rimuovere i dati precedenti.

Scenario 3: come controllare i prodotti utilizzando allowableRoomIDs

Come faccio a controllare i prodotti (combinazioni di tipi di camera e pacchetti) quando i tipi di camera sono raggruppati per pacchetto?

Nota: se i pacchetti sono raggruppati per tipo di camera, consulta lo Scenario 2.

Descrizione

Una combinazione di tipo di camera e pacchetto non viene più venduta come prodotto o vuoi controllare cosa è incluso in un nuovo pacchetto. Ad esempio, vuoi specificare solo alcune tipologie, come le camere King e Queen con vista sul mare, con un pacco.

Soluzione

Invia un messaggio Transaction aggiornato che specifica i prodotti esatti inclusi con il pacchetto usando l'elemento <AllowableRoomIDs>.

Esempio

Questo snippet XML mostra come utilizzare <AllowableRoomID> per specificare il re vista sull'oceano e tipi di camere matrimoniali nel pacchetto.

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