Hotel API

Nota

Questa versione beta di Hotel Price Ads è disponibile solo per selezionare i partecipanti. Per informazioni sulla partecipazione al programma di versione beta, contattare il proprio account manager o registrarsi qui.

L'API e la documentazione sono soggette a modifiche.

L'API Hotel consente di gestire le campagne pubblicitarie e le offerte degli hotel.

Le nozioni di base...

Quando si ottiene l'accesso a Hotel Price Ads, il servizio configura un account secondario predefinito e un gruppo di hotel che contiene gli hotel dal feed dell'hotel. L'account secondario fornisce l'organizzazione logica di primo livello degli annunci sui prezzi degli hotel. Si può pensare ad esso come una campagna di alloggio (in precedenza campagne di hotel). È possibile che siano presenti più account secondari.

Un account secondario specifica il budget giornaliero della campagna, l'offerta massima consentita e i moltiplicatori di offerte e offerte predefiniti per gli annunci che non specificano offerte o moltiplicatori.

I gruppi di hotel offrono un altro livello per raggruppare logicamente gli annunci sui prezzi degli hotel. Un gruppo di hotel appartiene a un singolo account secondario. Il gruppo di hotel predefinito creato dal servizio è denominato Ungrouped. Contiene tutti gli hotel dal feed iniziale dell'hotel e tutti i nuovi hotel in futuro.

Un gruppo di hotel specifica i moltiplicatori di offerta e offerta predefiniti per gli annunci che non specificano offerte o moltiplicatori. Se non si specificano offerte e moltiplicatori, il gruppo li eredita dal sottoaccount.

Dopo aver configurato l'account secondario e il gruppo di hotel, è possibile iniziare a importare i dati del feed dell'hotel. Per informazioni, vedere Configurare il feed dell'hotel?

Gli hotel appartengono a un singolo gruppo di hotel. Gli hotel specificano i moltiplicatori di offerte e offerte da utilizzare per l'annuncio dell'hotel. Se non si specificano offerte e moltiplicatori, l'hotel li eredita dal gruppo di hotel o dall'account secondario, in tale ordine.

Per informazioni sul trasferimento dell'hotel in un gruppo di hotel diverso, vedere Associazione di hotel con gruppi di hotel.

Cosa deve essere in atto prima di iniziare?

Saranno necessarie le credenziali e i feed dell'hotel configurati. Per informazioni, vedere Introduzione.

Il responsabile dell'account deve anche abilitare l'account per l'uso di Hotel Price Ads sia negli ambienti di produzione che in quello sandbox.

Ricerca per categorie gestire le risorse?

Le sezioni seguenti illustrano come gestire gli account secondari, i gruppi di hotel e gli hotel. Per informazioni sugli endpoint, l'intestazione, i parametri di query e le risorse, vedere Informazioni di riferimento sull'API Hotel.

Argomento	Descrizione
Uso degli account secondari	Fornisce informazioni sull'elenco degli account secondari, sul recupero di un singolo account secondario e sull'aggiornamento di un account secondario.
Uso di gruppi di hotel	Fornisce informazioni sull'elenco dei gruppi di hotel di un account secondario, sull'acquisizione di un singolo gruppo di hotel, sull'aggiunta di un gruppo di hotel e sull'aggiornamento di un gruppo di hotel.
Uso degli hotel	Fornisce informazioni su come elencare tutti gli hotel nell'account secondario, elencare gli hotel in un gruppo di hotel, ottenere un singolo hotel da un gruppo di hotel e aggiornare un hotel.
Associazione di un hotel a un gruppo di hotel	Fornisce informazioni su come associare un hotel a un gruppo di hotel.

Per esempi di codice, vedere Esempi.