Esta página apresenta alguns exemplos de chamadas usando a API Travel Partner v3.
Os endpoints da API Travel Partner aceitam sintaxe RESTful em chamadas HTTPS. O base_url para todas as solicitações de API é:
https://travelpartner.googleapis.com/v3/accounts/account_id
Para conferir a lista completa de campos de solicitação e resposta, consulte o catálogo de recursos da API.
Relatório de performance da propriedade
O serviço de visualização de relatórios de performance da propriedade permite consultar (receber, filtrar e segmentar) um relatório de performance de uma propriedade para uma conta específica.
Como consultar um relatório de performance da propriedade
O exemplo a seguir recebe o relatório de performance de todas as propriedades na conta 12345678
, filtrado para a data de 11 de maio de 2022 e agrupado por ID do hotel parceiro.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Hotéis
O Serviço de visualização de hotéis fornece uma lista de todos os hotéis ou um resumo deles para uma conta específica.
Como receber uma lista de hotéis
O exemplo a seguir recupera uma lista de todos os hotéis na conta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
A solicitação aceita parâmetros de consulta para navegar pelos resultados de várias páginas:
GET base_url/hotelViews?pageSize=10&pageToken=11
Como acessar um resumo das propriedades
Este exemplo recebe um resumo das propriedades da conta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
Relatório de participação
O serviço de visualização de relatórios de participação permite consultar (receber, filtrar e segmentar) um relatório de participação de uma conta específica.
Consultar um relatório de participação
O exemplo a seguir recebe o relatório de participação de todas as propriedades na conta 12345678
e filtra o relatório usando a data de 04/10/20.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
Nível de precisão do preço
O serviço de visualizações de nível de precisão do preço permite recuperar relatórios e quadros de visão geral de nível de precisão do preço de uma conta específica.
Como receber um relatório de nível de precisão do preço
O exemplo a seguir recupera o relatório de nível de precisão do preço de 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 na resposta, há mais alguns para incluir preços correspondentes ou indicadores de pixel nos resultados.
Neste exemplo, o relatório de nível de precisão do preço de 26/08/2019 inclui preços correspondentes e indicadores do pixel:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Listar relatórios de nível de precisão do preço disponíveis
Para receber uma lista dos relatórios disponíveis, envie esta solicitação:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
É possível incluir os parâmetros de consulta comuns para paginação dos resultados.
Como receber uma pontuação por nível de precisão do preço
Para acessar o quadro de indicadores de precisão do preço, use o método summarize
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
Cobertura de preços
O serviço de visualizações de cobertura de preços fornece o relatório mais recente de cobertura de preços ou todo o histórico de cobertura de preços.
Como acessar as estatísticas mais recentes de cobertura de preço
O exemplo a seguir recupera as estatísticas de cobertura de preço mais recentes da conta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
Como acessar o histórico de cobertura de preços
Esta solicitação recebe todo o histórico de cobertura de preços de uma conta:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
Preço
O serviço de visualizações de preços permite recuperar um relatório de preços de uma determinada propriedade.
Como receber dados de preços de uma propriedade
Para receber o relatório de preços de um hotel específico (ID=101
) pertencente à conta 12345678
, faça esta solicitação:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
Relatórios de conciliação
Com o serviço de relatórios de conciliação, você pode receber uma lista de relatórios, baixar um relatório específico, validá-lo e fazer upload para o Google.
Como receber uma lista de relatórios de conciliação
O exemplo a seguir recebe uma lista de relatórios da conta 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
É possível incluir parâmetros de consulta de data de início e término opcionais para limitar os resultados. Por exemplo, esta consulta restringe os relatórios apenas aos períodos entre 15/06/2019 e 15/09/2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Baixar um relatório de conciliação
Este exemplo recupera o relatório booking_report.csv
(como uma resposta JSON) que foi enviado em 2019-08-26T12:00:00
:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Validar um relatório de conciliação
Você pode usar esse método para validar o relatório antes de fazer upload dele. A validação não faz upload do relatório.
O relatório de conciliação é 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 da conta 12345678
:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Como fazer upload de um relatório de conciliação
Depois de confirmar que um relatório de conciliação é válido, faça upload dele para o Google, como neste exemplo:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports