Interroger un rapport sur les performances de la propriété
Dans l'exemple suivant, le rapport sur les performances de tous les établissements du compte 12345678 est filtré en fonction de la date du 11 mai 2022, et regroupé par ID d'hôtel partenaire.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
L'exemple suivant récupère le rapport sur la précision des prix du 26/08/2019 pour le compte 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
En plus des paramètres de requête habituels pour la pagination dans la réponse, il en existe d'autres pour inclure les prix correspondants ou les signaux de pixels dans les résultats.
Dans cet exemple, le rapport sur la précision des prix du 26/08/2019 inclut les prix correspondants et les signaux de pixels:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Répertorier les rapports sur la précision des prix disponibles
Pour obtenir la liste des rapports disponibles, envoyez la requête suivante:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
L'exemple suivant permet d'obtenir la liste des rapports du compte 12345678 :
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Vous pouvez inclure des paramètres de requête de date de début et de fin facultatifs pour limiter les résultats. Par exemple, cette requête limite les rapports à ceux du 15/06/2019 au 15/09/2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Cet exemple récupère le rapport booking_report.csv (sous forme de réponse JSON) importé à 2019-08-26T12:00:00 :
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Exemple de réponse
{
"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"
}
Valider un rapport de rapprochement
Cette méthode vous permet de valider le rapport avant de l'importer. Le fait de valider un rapport ne l'importe pas.
Le rapport de rapprochement est inclus dans le corps de la demande, en tant que valeur du champ contents. Le rapport de rapprochement doit respecter la syntaxe décrite dans la section Rapports de rapprochement.
L'exemple suivant valide le rapport du compte 12345678:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Exemple de réponse réussie
{
"successfulRecordCount": 3
}
Importer un rapport de rapprochement
Une fois que vous avez confirmé la validité d'un rapport de rapprochement, vous pouvez l'importer dans Google, comme dans cet exemple:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Tous droits réservés. Java est une marque déposée d'Oracle et/ou ses affiliés.
Dernière mise à jour le 2022/08/23 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]],[]]
