Usage

Questa pagina presenta alcune chiamate di esempio che utilizzano l'API Travel Partner v3.

Gli endpoint dell'API Travel Partner accettano la sintassi RESTful nelle chiamate HTTPS. Il base_url per tutte le richieste API è:

https://travelpartner.googleapis.com/v3/accounts/account_id

Per l'elenco completo dei campi di richiesta e risposta, consulta il catalogo delle risorse API.

Report sul rendimento della proprietà

Il servizio di visualizzazione del report sul rendimento della proprietà consente di eseguire query (recuperare, filtrare e segmentare) su un report sul rendimento della proprietà per un determinato account.

Eseguire query su un report sul rendimento della proprietà

Il seguente esempio recupera il report sul rendimento della proprietà per tutte le proprietà nell'account 12345678, filtrato in base alla data dell'11 maggio 2022 e raggruppato per ID hotel partner.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId

Hotel

Il servizio di visualizzazione degli hotel fornisce un elenco di tutti gli hotel o un riepilogo di quelli di un determinato account.

Ottenere un elenco di hotel

L'esempio seguente recupera un elenco di tutti gli hotel nell'account 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews

La richiesta accetta parametri della query per spostarsi tra i risultati di più pagine:

GET base_url/hotelViews?pageSize=10&pageToken=11

Visualizzare un riepilogo delle proprietà

Questo esempio recupera un riepilogo delle proprietà per l'account 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize

Report sulla partecipazione

Il servizio di visualizzazione del report sulla partecipazione consente di eseguire query (recuperare, filtrare e segmentare) su un report sulla partecipazione per un determinato account.

Esecuzione di query su un report sulla partecipazione

L'esempio seguente recupera il report sulla partecipazione per tutte le proprietà dell'account 12345678 e lo filtra utilizzando la data 10/04/20.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

Accuratezza del prezzo

Il servizio di visualizzazione dell'accuratezza del prezzo consente di recuperare i report e le schede di valutazione sull'accuratezza del prezzo per un determinato account.

Ricevere un report sull'accuratezza del prezzo

L'esempio seguente recupera il report sull'accuratezza del prezzo il 26/08/2019 per l'account 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826

Oltre ai soliti parametri di query per la paginazione della risposta, ce ne sono altri due per includere i prezzi corrispondenti o i segnali dei pixel nei risultati.

In questo esempio, il report sull'accuratezza del prezzo del 26/08/2019 include prezzi corrispondenti e pixel di monitoraggio:

GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true

Elenco dei report sull'accuratezza del prezzo disponibili

Per ottenere un elenco dei report disponibili, invia questa richiesta:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews

Puoi includere i soliti parametri di query per scorrere le pagine dei risultati.

Ottenere un punteggio di accuratezza del prezzo

Per ottenere il prospetto dell'accuratezza del prezzo, utilizza il metodo summarize:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize

Copertura dei prezzi

Il servizio di visualizzazione della copertura dei prezzi fornisce il report più recente sulla copertura dei prezzi o l'intera cronologia della copertura dei prezzi.

Visualizzare le ultime statistiche sulla copertura dei prezzi

L'esempio seguente recupera le statistiche più recenti sulla copertura dei prezzi per l'account 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

Ottenere la cronologia della copertura dei prezzi

Questa richiesta recupera l'intera cronologia della copertura dei prezzi per un account:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews

Prezzo

Il servizio Visualizzazioni prezzi ti consente di recuperare un report sui prezzi per una determinata proprietà.

Recupero dei dati sui prezzi per una proprietà

Per ottenere il report sui prezzi per un determinato hotel (ID=101) appartenente all'account 12345678, invia questa richiesta:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

Report sulle riconciliazioni

Il servizio di report sulle riconciliazioni ti consente di ottenere un elenco di report, scaricare un report specifico, convalidarlo e caricarlo su Google.

Visualizzare un elenco di report sulle riconciliazioni

L'esempio seguente recupera un elenco di report per l'account 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports

Puoi includere parametri di query facoltativi per le date di inizio e di fine per limitare i risultati. Ad esempio, questa query limita i report solo a quelli compresi tra il 15/06/2019 e il 15/09/2019:

GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15

Scaricare un report sulle riconciliazioni

Questo esempio recupera il report booking_report.csv (come risposta JSON) caricato alle ore 2019-08-26T12:00:00:

GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv

Convalida di un report sulle riconciliazioni

Puoi utilizzare questo metodo per convalidare il report prima di caricarlo. La convalida di un report non comporta il caricamento.

Il report di riconciliazione è incluso nel corpo della richiesta come valore del campo contents. Il report sulle riconciliazioni deve seguire la sintassi descritta nella sezione Report sulle riconciliazioni.

Il seguente esempio convalida un report per l'account 12345678:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate

Caricare un report sulle riconciliazioni

Dopo aver confermato la validità di un report sulle riconciliazioni, puoi caricarlo su Google come in questo esempio:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports