A API Travel Partner oferece uma interface RESTful para a plataforma da Central para Hotéis do Google. Ela permite que um app recupere e mude dados da Central para Hotéis de maneira eficiente, sendo adequada para gerenciar contas grandes ou complexas.
- Recurso REST: v3.accounts.accountLinks
- Recurso REST: v3.accounts.brands
- Recurso REST: v3.accounts.freeBookingLinksReportViews
- Recurso REST: v3.accounts.hotelViews
- Recurso REST: v3.accounts.hotels
- Recurso REST: v3.accounts.icons
- Recurso REST: v3.accounts.listings
- Recurso REST: v3.accounts.participationReportViews
- Recurso REST: v3.accounts.priceAccuracyViews
- Recurso REST: v3.accounts.priceCoverageViews
- Recurso REST: v3.accounts.priceViews
- Recurso REST: v3.accounts.propertyPerformanceReportViews
- Recurso REST: v3.accounts.reconciliationReports
Serviço: travelpartner.googleapis.com
Para chamar esse serviço, recomendamos que você use as bibliotecas de cliente fornecidas pelo Google. Caso o aplicativo precise usar bibliotecas próprias para chamar esse serviço, use as informações a seguir quando fizer as solicitações da API.
Documento de descoberta
Um Documento de descoberta é uma especificação legível por máquina para descrever e consumir APIs REST. Ele é usado para criar bibliotecas de cliente, plug-ins de IDE e outras ferramentas que interagem com as APIs do Google. Um serviço pode fornecer vários documentos de descoberta. O serviço fornece o seguinte documento de descoberta:
Endpoint de serviço
Um endpoint de serviço é um URL de base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Este serviço tem o endpoint a seguir, e todos os URIs abaixo são relativos a ele:
https://travelpartner.googleapis.com
Recurso REST: v3.accounts.accountLinks
| Métodos | |
|---|---|
create |
POST /v3/{parent=accounts/*}/accountLinks Cria um novo vínculo entre uma conta da Central para Hotéis e uma conta do Google Ads. |
delete |
DELETE /v3/{name=accounts/*/accountLinks/*} Exclui uma vinculação de conta. |
get |
GET /v3/{name=accounts/*/accountLinks/*} Retorna a instância AccountLink associada ao nome do recurso de vinculação de conta especificado no URL da solicitação. |
list |
GET /v3/{parent=accounts/*}/accountLinks Retorna os links de conta de uma conta da Central para Hotéis. |
patch |
PATCH /v3/{accountLink.name=accounts/*/accountLinks/*} Atualiza o destino da vinculação de conta. |
Recurso REST: v3.accounts.brands
| Métodos | |
|---|---|
create |
POST /v3/{parent=accounts/*}/brands Cria uma nova marca. |
get |
GET /v3/{name=accounts/*/brands/*} Retorna a instância Brand associada ao nome do recurso de marca do URI da solicitação. |
list |
GET /v3/{parent=accounts/*}/brands Retorna as marcas de uma conta de parceiro. |
patch |
PATCH /v3/{brand.name=accounts/*/brands/*} Atualiza uma marca. |
Recurso REST: v3.accounts.freeBookingLinksReportViews
| Métodos | |
|---|---|
query |
GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query DESCONTINUADO:use PropertyPerformanceReportService.QueryPropertyPerformanceReport, que também tem relatórios de impressão. |
Recurso REST: v3.accounts.hotelViews
| Métodos | |
|---|---|
list |
GET /v3/{parent=accounts/*}/hotelViews Retorna a lista de visualizações de hotéis. |
summarize |
GET /v3/{parent=accounts/*}/hotelViews:summarize Retorna informações resumidas sobre hotéis. |
Recurso REST: v3.accounts.hotels
| Métodos | |
|---|---|
setLiveOnGoogle |
POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle Método personalizado no nível da coleção para atualizar o status "Publicação ativa no Google" de várias propriedades. |
Recurso REST: v3.accounts.icons
| Métodos | |
|---|---|
create |
POST /v3/{parent=accounts/*}/icons Faz upload de um novo ícone e inicia o processo de revisão dele. |
get |
GET /v3/{name=accounts/*/icons/*} Retorna a instância Icon associada a um nome de recurso de ícone especificado no URI da solicitação. |
list |
GET /v3/{parent=accounts/*}/icons Retorna os Icons de uma conta de parceiro. |
Recurso REST: v3.accounts.listings
| Métodos | |
|---|---|
verify |
POST /v3/{parent=accounts/*}/listings:verify Retorna fichas verificadas com problemas de dados e qualificações de veiculação apenas para parceiros de RV. |
Recurso REST: v3.accounts.participationReportViews
| Métodos | |
|---|---|
query |
GET /v3/{name=accounts/*}/participationReportViews:query Permite consultar (receber, filtrar e segmentar) um relatório de participação de uma conta específica. |
Recurso REST: v3.accounts.priceAccuracyViews
| Métodos | |
|---|---|
get |
GET /v3/{name=accounts/*/priceAccuracyViews/*} Retorna a visualização de nível de precisão do preço solicitada com todos os detalhes. |
list |
GET /v3/{parent=accounts/*}/priceAccuracyViews Lista as visualizações de nível de precisão do preço disponíveis. |
summarize |
GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize Retorna o resumo do nível de precisão do preço. |
Recurso REST: v3.accounts.priceCoverageViews
| Métodos | |
|---|---|
getLatest |
GET /v3/{parent=accounts/*}/priceCoverageViews:latest Retorna a visualização mais recente da cobertura de preços com todos os detalhes. |
list |
GET /v3/{parent=accounts/*}/priceCoverageViews Retorna todo o histórico de cobertura de preços. |
Recurso REST: v3.accounts.priceViews
| Métodos | |
|---|---|
get |
GET /v3/{name=accounts/*/priceViews/*} Retorna a visualização de preço solicitada com todos os detalhes. |
Recurso REST: v3.accounts.propertyPerformanceReportViews
| Métodos | |
|---|---|
query |
GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query Permite consultar (receber, filtrar e segmentar) um relatório de links sem custo financeiro para reserva de uma conta específica. |
Recurso REST: v3.accounts.reconciliationReports
| Métodos | |
|---|---|
create |
POST /v3/{parent=accounts/*}/reconciliationReports Cria um relatório de conciliação e faz upload dele para o Google. |
get |
GET /v3/{name=accounts/*/reconciliationReports/*} Retorna um relatório de conciliação. |
list |
GET /v3/{parent=accounts/*}/reconciliationReports Retorna uma lista dos nomes dos relatórios de conciliação criados. |
validate |
POST /v3/{parent=accounts/*}/reconciliationReports:validate Valida um relatório de conciliação. |