A versão 3 da API Travel Partner oferece acesso programático a:
- Gerenciamento de vinculações de contas entre a Central para Hotéis e o Google Ads
- Gerenciamento das configurações de hotel selecionadas
- Gerenciamento de marcas e ícones (Beta fechada)
- Dados de performance da propriedade usando o serviço de visualizações de relatórios de performance da propriedade
- Dados de hotéis pelo serviço de visualizações de hotéis
- Dados do relatório de participação pelo serviço de visualizações do relatório de participação
- Dados de nível de precisão do preço pelo serviço de visualizações de nível de precisão do preço
- Dados de cobertura de preços pelo serviço de visualizações de cobertura de preços
- Dados de itinerário e preços pelo serviço Price Views
- Gerenciamento de relatórios de conciliação de comissões pelo serviço de relatórios de conciliação (somente parceiros de pagamento por estadia de comissão)
Endpoints
Os endpoints da API Travel Partner podem ser acessados por sintaxe RESTful de chamadas HTTPS. O URL de base para todas as solicitações é:
https://travelpartner.googleapis.com
| Endpoints de Serviço | |
|---|---|
| Links de contas | Gerencia os links entre uma conta do Google Ads e uma conta da Central para Hotéis.
|
| Marcas | Modifique a configuração da marca. (Beta fechado)
|
| Hotéis | Modifique as configurações de hotel selecionadas.
|
| Visualizações de hotéis | Retorna a lista de visualizações de hotéis ou um resumo.
|
| Ícones | Gerenciar ícones. (Beta fechado)
|
| Visualizações do relatório de participação | Retorna uma visualização de relatório de participação ou, usando uma consulta, retorna um subconjunto filtrado dos dados da visualização.
|
| Visualizações de precisão de preços | Retorna uma visualização específica do nível de precisão do preço, as visualizações de nível de precisão disponíveis ou um resumo.
|
| Visualizações de cobertura de preços | Retorna a visualização mais recente da cobertura de preços ou todo o histórico de cobertura.
|
| Visualizações de preço | Retorna a visualização de preço solicitada com todos os detalhes.
|
| Visualizações do relatório de performance da propriedade | Retorna uma visualização de relatório de performance de propriedade usando uma consulta.
|
| Relatórios de conciliação | Cria, valida e recupera relatórios de conciliação de comissões (somente anúncios de hotel).
|
Você pode pesquisar o ID da conta na visualização Informações da conta da guia Conta na Central de anúncios de hotéis.
Registro de alterações
Muitos serviços na API Travel Partner v2.1 foram migrados para a API Google Ads. Como resultado, a API Travel Partner v3 retém apenas serviços específicos de hotéis.
HotelViewService
HotelViewService.ListHotelViews(antiga API Hotels)- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/hotelsparahttps://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews. - Remoção do parâmetro de solicitação
type. - O campo
manifestOnlyfoi removido da resposta. - Alguns campos foram renomeados.
- O endpoint da API mudou de
HotelViewService.SummarizeHotelViews(antigohotel_list_statsna API Scorecard)- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_statsparahttps://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize. - Alguns campos foram renomeados.
- O endpoint da API mudou de
ParticipationReportViewService (antigo opportunity_stats na API Scorecard)
ParticipationReportService.QueryParticipationReport- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_statsparahttps://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query. - Parâmetros de consulta foram adicionados.
- Os campos foram renomeados e reestruturados.
- O endpoint da API mudou de
PriceAccuracyViewService (antiga API de relatórios price_accuracy)
PriceAccuracyViewService.ListPriceAccuracyViews- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracyparahttps://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews. - A nova API retorna uma lista de nomes de recursos de visualização de hotel, em vez da versão anterior, que retornava uma lista de datas de relatório.
- O endpoint da API mudou de
PriceAccuracyViewService.ListPriceAccuracyViews- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909parahttps://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909. - A saída CSV não é mais compatível.
- Alguns campos foram renomeados.
- O endpoint da API mudou de
PriceCoverageViewService
PriceAccuracyViewService.ListPriceCoverageViews(antigoprice_coverage_stats_historyna API Scorecard)- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_historyparahttps://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews. - Alguns campos foram renomeados.
- O endpoint da API mudou de
PriceAccuracyViewService.GetLatestPriceCoverageViews(antigoprice_coverage_statsna API Scorecard)- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_statsparahttps://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest. - Alguns campos foram renomeados.
- O endpoint da API mudou de
PriceViewService (antiga API Prices)
PriceViewService.GetPriceView- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_idparahttps://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id. - Alguns campos foram renomeados.
- As informações de lances foram removidas da resposta.
- O endpoint da API mudou de
Métodos ReconciliationReportService (antiga API Reconciliation Reports)
ReconciliationReportService.ListReconciliationReports- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reportsparahttps://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
- O endpoint da API mudou de
ReconciliationReportService.GetReconciliationReport- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filenameparahttps://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
- O endpoint da API mudou de
ReconciliationReportService.CreateReconciliationReport- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reportsparahttps://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
- O endpoint da API mudou de
ReconciliationReportService.ValidateReconciliationReport- O endpoint da API mudou de
https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validateparahttps://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.
- O endpoint da API mudou de
Suspensão de uso
- Descontinuado
- indica que a versão da API vai continuar funcionando normalmente, mas pode não ser atualizada com novos recursos ou correções de bugs. Além disso, quando uma versão é descontinuada, uma data de desativação é determinada.
- Desativado
- indica que a versão da API foi removida e não está mais disponível. O período mínimo entre a descontinuação e o encerramento é de três meses.
A tabela a seguir mostra a programação atual das versões da API, bem como as datas esperadas de suspensão de uso e desativação:
| Versão | Data de descontinuação | Data de desativação |
|---|---|---|
| v3.0 | N/A | N/A |
| v2.1 | Setembro de 2019 | 31 de maio de 2020 |
| v2.0 (API Bids) | Fevereiro de 2018 | Maio de 2018 |
| v2.0 (todas as outras APIs) | Setembro de 2019 | 15 de fevereiro de 2020 |
| v1.2 | Fevereiro de 2018 | Maio de 2018 |
| v1.1 | Junho de 2016 | Outubro de 2016 |
| v1.0 | Abril de 2015 | Outubro de 2015 |
Autenticação
Para acessar a API Travel Partner, os clientes precisam fazer a autenticação usando a autenticação OAuth2.
Para um exemplo de aplicativo e mais informações sobre como usar o OAuth para se conectar à API Travel Partner, consulte Autenticação de API.