Release Notes

A versão 3 da API Travel Partner oferece acesso programático a:

• Gerenciamento de vinculações de conta entre a Central para Hotéis e o Google Ads
• Gerenciamento das configurações do hotel selecionado
• Gerenciamento de marcas e ícones (versão Beta fechada)
• Dados de desempenho da propriedade usando o Serviço de visualizações de relatórios de desempenho da propriedade
• Dados do hotel 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 por meio do Serviço de visualizações por nível de precisão do preço
• Dados de cobertura de preço com o serviço de cobertura de preços
• Dados de itinerário e preço com o serviço "Visualizações de preço"
• Gerenciamento de relatórios de reconciliação de comissões pelo Serviço de Relatórios de reconciliação (somente parceiros de pagamento por estadia)

Endpoints

Os endpoints da API Travel Partner podem ser acessados com a sintaxe REST de chamadas HTTPS. O URL base para todas as solicitações é:

https://travelpartner.googleapis.com

Endpoints de Serviço
Vinculações da conta	Gerencia vinculações entre uma conta do Google Ads e uma conta da Central para Hotéis. POST /v3/accounts/account id/accountLinks DELETE /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks/account link id GET /v3/accounts/account id/accountLinks PATCH /v3/accounts/account id/accountLinks/account link id
Marcas	Modificar a configuração da marca. (versão Beta fechada) POST /v3/accounts/account id/brands GET /v3/accounts/account id/brands PATCH /v3/accounts/account id/brands/brand id
Hotéis	Modificar configurações de hotéis selecionadas. POST /v3/accounts/account id/hotels:setLiveOnGoogle
Visualizações de hotéis	Retorna a lista de visualizações de hotéis ou um resumo. GET /v3/accounts/account id/hotelViews GET /v3/accounts/account id/hotelViews:summarize
Ícones	Gerenciar ícones. (versão Beta fechada) POST /v3/accounts/account id/icons GET /v3/accounts/account id/icons/icon id
Visualizações do relatório de participação	Retorna uma visualização do relatório de participação ou, usando uma consulta, retorna um subconjunto filtrado dos dados da visualização. GET /v3/accounts/account id/participationReportViews GET /v3/accounts/account id/participationReportViews:query
Visualizações por nível de precisão do preço	Retorna uma visualização específica do nível de precisão do preço, as visualizações por nível de precisão do preço disponíveis ou um resumo. GET /v3/accounts/account id/priceAccuracyViews/report date GET /v3/accounts/account id/priceAccuracyViews GET /v3/accounts/account id/priceAccuracyViews:summarize
Visualizações de cobertura de preços	Retorna a visualização mais recente de cobertura de preço ou todo o histórico de cobertura. GET /v3/accounts/account id/priceCoverageViews:latest GET /v3/accounts/account id/priceCoverageViews
Visualizações de preço	Retorna a visualização de preços solicitada com todos os detalhes. GET /v3/accounts/account id/priceViews/partner hotel id
Visualizações do relatório de desempenho da propriedade	Retorna uma visualização de relatório de desempenho da propriedade usando uma consulta. GET /v3/accounts/account id/participationReportViews:query
Relatórios de reconciliação	Cria, valida e recupera relatórios de reconciliação de comissões (somente Anúncios de hotéis). POST /v3/accounts/account id/reconciliationReports POST /v3/accounts/account id/reconciliationReports:validate GET /v3/accounts/account id/reconciliationReports/datetime~filename GET /v3/accounts/account id/reconciliationReports

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 para hotéis.

Serviço de visualização de hotéis

• HotelViewService.ListHotelViews (antiga API Hotels)
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/hotels para https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
  • Remoção do parâmetro de solicitação type.
  • Remoção do campo manifestOnly na resposta.
  • Alguns campos foram renomeados.
• HotelViewService.SummarizeHotelViews (antiga hotel_list_stats na API Scorecard)
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats para https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
  • Alguns campos foram renomeados.

ParticipationReportViewService (antiga oportunidade_stats na API Scorecard)

• ParticipationReportService.QueryParticipationReport
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats para https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
  • Os parâmetros de consulta foram adicionados.
  • Os campos foram renomeados e reestruturados.

PricePrecisãoViewService (antiga API de relatório price_accuracy)

• PriceAccuracyViewService.ListPriceAccuracyViews
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy para https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
  • A nova API retorna uma lista de nomes de recursos da visualização de hotéis em vez da versão anterior, que retorna uma lista de datas de relatório.
• PriceAccuracyViewService.ListPriceAccuracyViews
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 para https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
  • A saída CSV não é mais compatível.
  • Alguns campos foram renomeados.

Serviço de cobertura de preços

• PriceAccuracyViewService.ListPriceCoverageViews (antiga price_coverage_stats_history na API Scorecard)
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history para https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
  • Alguns campos foram renomeados.
• PriceAccuracyViewService.GetLatestPriceCoverageViews (antiga price_coverage_stats na API Scorecard)
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats para https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
  • Alguns campos foram renomeados.

PriceViewService (antiga API Price)

• PriceViewService.GetPriceView
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id para https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
  • Alguns campos foram renomeados.
  • Informações de lances removidas da resposta.

Métodos reconciliationReportService (anteriormente API de relatórios de reconciliação)

• ReconciliationReportService.ListReconciliationReports
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports para https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
• ReconciliationReportService.GetReconciliationReport
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename para https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
• ReconciliationReportService.CreateReconciliationReport
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports para https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
• ReconciliationReportService.ValidateReconciliationReport
  • O endpoint da API mudou de https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate para https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

Suspensão de uso

Descontinuada

indica que a versão da API continua funcionando normalmente, mas não recebe atualizações de novos recursos ou correções de bugs. Além disso, quando uma versão é descontinuada, uma data de desativação é determinada.

Desativada

indica que a versão da API foi removida e não está mais disponível. O período mínimo de tempo entre a descontinuação e a desativação é de três meses.

A tabela a seguir mostra a programação atual de versões da API, além das datas de suspensão e descontinuação esperadas:

Versão	Data da suspensão	Data da desativação
v3.0	N/A	N/A
v2.1	Setembro de 2019	31 de maio de 2020
v2.0 (API de lances)	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 do OAuth2.

Para ver um exemplo de aplicativo e outras informações sobre como usar o OAuth para se conectar à API Travel Partner, consulte Autenticação de APIs.