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.
|
| Marcas | Modificar a configuração da marca. (versão Beta fechada)
|
| Hotéis | Modificar configurações de hotéis selecionadas.
|
| Visualizações de hotéis | Retorna a lista de visualizações de hotéis ou um resumo.
|
| Ícones | Gerenciar ícones. (versão Beta fechada)
|
| 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.
|
| 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.
|
| 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.
|
| Visualizações de preço | Retorna a visualização de preços solicitada com todos os detalhes.
|
| Visualizações do relatório de desempenho da propriedade | Retorna uma visualização de relatório de desempenho da propriedade usando uma consulta.
|
| Relatórios de reconciliação | Cria, valida e recupera relatórios de reconciliação de comissões (somente Anúncios de hotéis).
|
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/hotelsparahttps://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews. - Remoção do parâmetro de solicitação
type. - Remoção do campo
manifestOnlyna resposta. - Alguns campos foram renomeados.
- O endpoint da API mudou de
HotelViewService.SummarizeHotelViews(antigahotel_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 (antiga oportunidade_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. - Os parâmetros de consulta foram adicionados.
- Os campos foram renomeados e reestruturados.
- O endpoint da API mudou de
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_accuracyparahttps://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.
- 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
Serviço de cobertura de preços
PriceAccuracyViewService.ListPriceCoverageViews(antigaprice_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(antigaprice_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 Price)
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.
- Informações de lances removidas da resposta.
- O endpoint da API mudou de
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_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
- 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.