Release Notes

La versione 3 dell'API Travel Partner offre accesso programmatico a:

  • Gestione dei collegamenti degli account tra Hotel Center e Google Ads
  • Gestione delle impostazioni dell'hotel selezionate
  • Gestione di brand e icone (beta chiusa)
  • Dati sul rendimento della proprietà tramite il servizio di visualizzazioni del report sul rendimento della proprietà
  • Dati degli hotel tramite il servizio Hotel Views
  • Dati del report sulla partecipazione tramite il servizio di visualizzazione del report sulla partecipazione
  • Dati sull'accuratezza del prezzo tramite il servizio Price Accuracy Views
  • Dati sulla copertura dei prezzi tramite il servizio di visualizzazioni della copertura dei prezzi
  • Dati su itinerari e prezzi tramite il servizio Price Views
  • Gestione dei report di riconciliazione delle commissioni tramite il servizio di report di riconciliazione (solo per i partner con pagamento per soggiorno)

Endpoint

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

https://travelpartner.googleapis.com

Endpoint di servizio
Link degli 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 la 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

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

Gestire le icone. (beta chiusa)

POST /v3/accounts/account id/icons
GET /v3/accounts/account id/icons/icon id

Visualizzazioni del report sulla partecipazione

Restituisce una visualizzazione del report sulla partecipazione oppure, utilizzando una query, restituisce un sottoinsieme filtrato dei dati della visualizzazione.

GET /v3/accounts/account id/participationReportViews
GET /v3/accounts/account id/participationReportViews:query

Visualizzazioni dell'accuratezza del prezzo

Restituisce una visualizzazione specifica dell'accuratezza del prezzo, le visualizzazioni dell'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 più recente della copertura dei prezzi o l'intera cronologia della copertura.

GET /v3/accounts/account id/priceCoverageViews:latest
GET /v3/accounts/account id/priceCoverageViews

Visualizzazioni del prezzo

Restituisce la visualizzazione del prezzo richiesta in dettaglio.

GET /v3/accounts/account id/priceViews/partner hotel id

Visualizzazioni del report sul rendimento della proprietà

Restituisce una visualizzazione del report sul rendimento della proprietà utilizzando una query.

GET /v3/accounts/account id/participationReportViews:query

Report sulle riconciliazioni

Crea, convalida e recupera i report di riconciliazione delle 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 account della scheda Account in Hotel Ads Center.

Log delle modifiche

Molti servizi dell'API Travel Partner v2.1 sono stati migrati all'API Google Ads. Di conseguenza, l'API Travel Partner v3 conserva solo i servizi specifici per gli hotel.

HotelViewService

  • HotelViewService.ListHotelViews (in precedenza API Hotels)
    • L'endpoint API è cambiato da https://www.googleapis.com/travelpartner/v2.1/4200042/hotels a https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
    • È stato rimosso il parametro di richiesta type.
    • Rimosso il campo manifestOnly 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 opportunity_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 query sono stati aggiunti.
    • I campi sono stati rinominati e ristrutturati.

PriceAccuracyViewService (in precedenza API per i report sull'accuratezza del prezzo)

  • 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 di visualizzazione degli hotel, a differenza della 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.

PriceCoverageViewService

  • 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 Prices)

  • 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.
    • Le informazioni sulle offerte sono state rimosse dalla risposta.

Metodi ReconciliationReportService (in precedenza API per i report sulle riconciliazioni)

  • 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 viene ritirata, viene determinata una data di ritiro.
Ritirato
indica che la versione dell'API è stata rimossa e non è più disponibile. Il periodo minimo di tempo tra il ritiro e il ritiro definitivo è di 3 mesi.

La tabella seguente mostra la pianificazione attuale delle versioni dell'API, nonché le date previste per il ritiro e il ritiro definitivo:

Versione Data di ritiro Data di ritiro
v3.0 N/D N/D
v2.1 Settembre 2019 31 maggio 2020
v2.0 (API Bids) 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 autenticarsi utilizzando l'autenticazione OAuth2.

Per un'applicazione di esempio e ulteriori informazioni sull'utilizzo di OAuth per connettersi all'API Travel Partner, consulta Autenticazione API.