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.