Questa pagina è stata tradotta dall'API Cloud Translation.

Release Notes

La versione 3 dell'API Travel Partner consente di accedere in modo programmatico a:

Gestione dei collegamenti degli account tra Hotel Center e Google Ads
Gestione delle impostazioni dell'hotel selezionate
Gestione di brand e icone (versione beta chiusa)
Dati sul rendimento delle proprietà tramite il servizio Visualizzazioni report sul rendimento delle proprietà
Dati degli hotel tramite il servizio Visualizzazioni hotel
Dati dei report sulla partecipazione tramite il servizio Visualizzazioni report
Dati sull'accuratezza del prezzo tramite il servizio Visualizzazioni accuratezza del prezzo
Dati sulla copertura dei prezzi tramite il servizio Visualizzazioni di copertura del prezzo
Dati relativi a itinerario e prezzi tramite il servizio Visualizzazioni di prezzo
Gestione dei report sulle riconciliazioni di commissioni tramite il servizio di riconciliazione dei rapporti (solo per i partner che utilizzano il pagamento per soggiorno)

Endpoint

Gli endpoint dell'API Travel Partner sono accessibili tramite la sintassi REST-ful dalle chiamate HTTPS. L'URL di base per tutte le richieste è:

https://travelpartner.googleapis.com

Endpoint di servizio
Collegamenti account	Gestisce i collegamenti tra un account Google Ads e un account Hotel Center. `POST /v3/accounts/account id/accountLinks DELETE /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks PATCH /v3/accounts/account id/accountLinks/account link id`
Brand	Modifica configurazione del brand. (beta chiusa) `POST /v3/accounts/account id/brands GET /v3/accounts/account id/brands PATCH /v3/accounts/account id/brands/brand id`
Hotel	Modifica le impostazioni dell'hotel selezionate. `POST /v3/accounts/account id/hotels:setLiveOnGoogle`
Vista hotel	Restituisce l'elenco delle visualizzazioni di hotel o un riepilogo. `GET /v3/accounts/account id/hotelViews GET /v3/accounts/account id/hotelViews:summarize`
Icone	Gestisci le icone. (beta chiusa) `POST /v3/accounts/account id/icons GET /v3/accounts/account id/icons/icon id`
Visualizzazioni dei report sulla partecipazione	Restituisce una vista del report sulla partecipazione oppure, utilizzando una query, restituisce un sottoinsieme filtrato dei dati della vista. `GET /v3/accounts/account id/participationReportViews GET /v3/accounts/account id/participationReportViews:query`
Visualizzazioni sull'accuratezza del prezzo	Restituisce una determinata visualizzazione dell'accuratezza del prezzo, visualizzazioni di accuratezza disponibili o un riepilogo. `GET /v3/accounts/account id/priceAccuracyViews/report date GET /v3/accounts/account id/priceAccuracyViews GET /v3/accounts/account id/priceAccuracyViews:summarize`
Visualizzazioni della copertura dei prezzi	Restituisce la visualizzazione della copertura dei prezzi più recente o l'intera cronologia della copertura. `GET /v3/accounts/account id/priceCoverageViews:latest GET /v3/accounts/account id/priceCoverageViews`
Visualizzazioni di prezzo	Restituisce la visualizzazione del prezzo richiesto in dettaglio. `GET /v3/accounts/account id/priceViews/partner hotel id`
Visualizzazioni del report sul rendimento delle proprietà	Restituisce una visualizzazione del report sul rendimento delle proprietà che utilizza una query. `GET /v3/accounts/account id/participationReportViews:query`
Report sulle riconciliazioni	Crea, convalida e recupera i report sulle riconciliazioni di commissioni (solo Hotel Ads). `POST /v3/accounts/account id/reconciliationReports POST /v3/accounts/account id/reconciliationReports:validate GET /v3/accounts/account id/reconciliationReports/datetime~filename GET /v3/accounts/account id/reconciliationReports`

Puoi cercare l'ID account nella visualizzazione Informazioni sull'account della scheda Account in Hotel Ads Center.

Log delle modifiche

È stata eseguita la migrazione di molti servizi dell'API Travel Partner v2.1 all'API Google Ads. Di conseguenza, l'API Travel Partner v3 conserva solo i servizi specifici per hotel.

HotelViewService

HotelViewService.ListHotelViews (in precedenza Hotels API)
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/hotels a https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
- Parametro di richiesta type rimosso.
- Il campo manifestOnly è stato rimosso nella risposta.
- Alcuni campi sono stati rinominati.
HotelViewService.SummarizeHotelViews (in precedenza hotel_list_stats nell'API Scorecard)
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats a https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
- Alcuni campi sono stati rinominati.

ParticipationReportViewService (in precedenza opportunità_stats nell'API Scorecard)

ParticipationReportService.QueryParticipationReport
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats a https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
- I parametri di ricerca sono stati aggiunti.
- I campi sono stati rinominati e ristrutturati.

PriceAccuracyViewService (in precedenza API price_accuracy)

PriceAccuracyViewService.ListPriceAccuracyViews
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy a https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
- La nuova API restituisce un elenco di nomi di risorse per la visualizzazione degli hotel anziché la versione precedente, che restituisce un elenco di date dei report.
PriceAccuracyViewService.ListPriceAccuracyViews
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 a https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
- L'output CSV non è più supportato.
- Alcuni campi sono stati rinominati.

Servizio di copertura e visualizzazione prezzo

PriceAccuracyViewService.ListPriceCoverageViews (in precedenza price_coverage_stats_history nell'API Scorecard)
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history a https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
- Alcuni campi sono stati rinominati.
PriceAccuracyViewService.GetLatestPriceCoverageViews (in precedenza price_coverage_stats nell'API Scorecard)
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats a https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
- Alcuni campi sono stati rinominati.

PriceViewService (in precedenza API Price)

PriceViewService.GetPriceView
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id a https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
- Alcuni campi sono stati rinominati.
- Informazioni sulle offerte rimosse dalla risposta.

Metodi di RiconciliazioneReportService (in precedenza API Report di riconciliazione)

ReconciliationReportService.ListReconciliationReports
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports a https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
ReconciliationReportService.GetReconciliationReport
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename a https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
ReconciliationReportService.CreateReconciliationReport
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports a https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
ReconciliationReportService.ValidateReconciliationReport
- L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate a https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

Ritiro

Deprecato: indica che la versione dell'API continuerà a funzionare come previsto, ma potrebbe non essere aggiornata con nuove funzionalità o correzioni di bug. Inoltre, quando una versione è deprecata, viene determinata una data di ritiro.
Tramonto: indica che la versione dell'API è stata rimossa e non è più disponibile. Il periodo di tempo minimo tra il ritiro e la disattivazione è di 3 mesi.

La tabella seguente mostra la programmazione corrente delle versioni dell'API, nonché le date di ritiro e ritiro previste:

Versione	Data ritiro	Data di tramonto
Versione 3.0	N/D	N/D
Versione 2.1	Settembre 2019	31 maggio 2020
v2.0 (API delle offerte)	Febbraio 2018	Maggio 2018
v2.0 (tutte le altre API)	Settembre 2019	15 febbraio 2020
v1.2	Febbraio 2018	Maggio 2018
v1.1	Giugno 2016	Ottobre 2016
v1.0	Aprile 2015	Ottobre 2015

Autenticazione

Per accedere all'API Travel Partner, i client devono eseguire l'autenticazione utilizzando l'autenticazione OAuth2.

Per un'applicazione di esempio e informazioni aggiuntive sull'utilizzo di OAuth per connetterti all'API Travel Partner, consulta la sezione Autenticazione API.