Como consultar um relatório de desempenho da propriedade
No exemplo a seguir, o relatório de desempenho de todas as propriedades na conta 12345678 é filtrado, filtrado até a data de 11 de maio de 2022 e agrupado pelo ID de hotel do parceiro.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Como gerar um relatório de nível de precisão do preço
O exemplo a seguir recupera o Relatório de precisão de preços em 26/08/2019 para a conta 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Além dos parâmetros de consulta comuns para paginação pela resposta, há mais alguns para incluir preços correspondentes ou sinais de pixel nos resultados.
Neste exemplo, o relatório de precisão de preços em 26/08/2019 inclui preços correspondentes e indicadores de pixel:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Como listar os relatórios de nível de precisão do preço
Para ver uma lista dos relatórios disponíveis, envie esta solicitação:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
O exemplo a seguir mostra uma lista de relatórios para a conta 12345678:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Você pode incluir parâmetros opcionais de consulta de data de início e de término para limitar os resultados. Por exemplo, esta consulta limita a geração de relatórios somente aos que estão entre 15/06/2019 e 15/09/2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Este exemplo recupera o relatório booking_report.csv (como uma resposta JSON) que foi carregado em 2019-08-26T12:00:00:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Exemplo de resposta
{
"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"
}
Validar um relatório de reconciliação
Você pode usar esse método para validar o relatório antes de fazer upload dele. A validação de um relatório não o envia.
O relatório de reconciliação está incluído no corpo da solicitação, como o valor do campo contents. O relatório de reconciliação precisa seguir a sintaxe descrita em Relatórios de reconciliação.
O exemplo a seguir valida um relatório para a conta 12345678:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Exemplo de resposta bem-sucedida
{
"successfulRecordCount": 3
}
Enviando um relatório de conciliação
Depois de confirmar que um relatório de reconciliação é válido, você poderá fazer upload dele para o Google como neste exemplo:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Todos os direitos reservados. Java é uma marca registrada da Oracle e/ou suas afiliadas.
Última atualização 2022-08-23 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]],[]]
