En esta página, se presentan algunas llamadas de ejemplo con la API de Travel Partner v3.
Los extremos de la API de Travel Partner usan sintaxis de REST y llamadas mediante HTTPS. El base_url para todas las solicitudes a la API es el siguiente:
Cómo consultar un informe de rendimiento de propiedades
En el siguiente ejemplo, se obtiene el informe de rendimiento de propiedades de todas las propiedades en la cuenta 12345678, filtrado hasta la fecha del 11 de mayo de 2022 y agrupado por ID de hotel de socio.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
En el siguiente ejemplo, se obtiene el informe de participación de todas las propiedades en la cuenta 12345678 y se filtra el informe con una fecha del 4/10/20.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
En el siguiente ejemplo, se recupera el informe de precisión del precio el 26 de agosto de 2019 de la cuenta 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Además de los parámetros de búsqueda habituales para paginar la respuesta, hay algunos más que permiten incluir precios coincidentes o indicadores de píxeles en los resultados.
En este ejemplo, el informe de precisión del precio del 26 de agosto de 2019 incluye indicadores coincidentes y precios de píxeles:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Enumera los informes de precisión de precios disponibles
Para obtener una lista de los informes disponibles, envía esta solicitud:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
Cómo obtener una lista de informes de conciliación
En el siguiente ejemplo, se obtiene una lista de informes para la cuenta 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Puede incluir parámetros opcionales de consulta de fecha de inicio y finalización para limitar los resultados. Por ejemplo, esta consulta limita los informes solo a aquellos entre el 15/6/2019 y el 15/9/2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
En este ejemplo, se recupera el informe booking_report.csv (como una respuesta JSON) que se subió en 2019-08-26T12:00:00:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Respuesta de muestra
{
"contents": "Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel PostalCode,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency to Billing Currency Conversion Rate,Payment Date,Payment Status\n\n111,\"Capybara Hotel and Spa\",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04,2016-02-01,2016-02-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required\n\n211,\"Mabels Gabels\",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-02-04,2016-02-01,2016-02-03,1,3,414.21,GBP,1.249,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required\n\n311,\"No-Tell Motels\",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-03-04,2016-02-01,2016-02-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,2016-06-07,Invoice Required"
}
Cómo validar un informe de conciliación
Puede usar este método para validar el informe antes de subirlo. La validación de un informe no lo sube.
El informe de conciliación se incluye en el cuerpo de la solicitud como el valor para el campo contents. El informe de conciliación debe seguir la sintaxis que se describe en Informes de conciliación.
En el siguiente ejemplo, se valida un informe para la cuenta 12345678:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Respuesta correcta de muestra
{
"successfulRecordCount": 3
}
Cómo subir un informe de conciliación
Una vez que haya confirmado que un informe de conciliación es válido, puede subirlo a Google de la siguiente manera:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Todos los derechos reservados. Java es una marca comercial de Oracle o sus afiliados.
Última actualización: 2022-08-23 (UTC)
[null,null,["Última actualización: 2022-08-23 (UTC)"],[[["The Travel Partner API uses REST-ful syntax for HTTPS calls to various endpoints, allowing access to data like property performance, hotel details, and price accuracy."],["You can query reports, like the Property Performance Report or the Participation Report, to gain insights into your hotel data using specific filters and aggregations."],["The API provides methods for retrieving hotel lists, summaries, price coverage information, and pricing data for individual properties within your account."],["Reconciliation Reports, specifically for Hotel Ads, can be listed, downloaded, validated, and uploaded through dedicated API endpoints."],["The base URL for all API requests is `https://travelpartner.googleapis.com/v3/accounts/account_id`, and detailed documentation for resources is available in the API resources catalog."]]],[]]
