Usage

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