A API Travel Partner oferece uma interface RESTful para a plataforma da Central para Hotéis do Google. Permite que um app recupere e altere dados da Central para Hotéis com eficiência e, portanto, é adequado 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.participationReportViews
- Recurso REST: v3.accounts.pricePrecisãoViews
- 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, use as bibliotecas de cliente fornecidas pelo Google. Se o aplicativo precisar usar suas próprias bibliotecas para chamar esse serviço, use as informações a seguir ao fazer as solicitações de 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 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 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 uma nova vinculação de conta 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 da vinculação de conta especificado no URL da solicitação. |
list |
GET /v3/{parent=accounts/*}/accountLinks Retorna os links de uma conta da Central para Hotéis. |
patch |
PATCH /v3/{accountLink.name=accounts/*/accountLinks/*} Atualiza o destino da vinculação de uma 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 da marca do URI de solicitação. |
list |
GET /v3/{parent=accounts/*}/brands Retorna as marcas de uma conta do 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ões. |
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 "Ao vivo 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. |
get |
GET /v3/{name=accounts/*/icons/*} Retorna a instância Icon associada a um nome de recurso de ícone especificado no URI de solicitação. |
list |
GET /v3/{parent=accounts/*}/icons Retorna os Icons de uma conta do parceiro. |
Recurso REST: v3.accounts.participationReportViews
| Métodos | |
|---|---|
query |
GET /v3/{name=accounts/*}/participationReportViews:query Oferece a capacidade de consultar (receber, filtrar e segmentar) um relatório de participação de uma conta específica. |
Recurso REST: v3.accounts.pricePrecisãoViews
| Métodos | |
|---|---|
get |
GET /v3/{name=accounts/*/priceAccuracyViews/*} Retorna a visualização detalhada do nível de precisão do preço solicitado. |
list |
GET /v3/{parent=accounts/*}/priceAccuracyViews Lista as visualizações por nível de precisão do preço disponíveis. |
summarize |
GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize Retorna o resumo 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 de cobertura de preço 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ços solicitada com todos os detalhes. |
Recurso REST: v3.accounts.propertyPerformanceReportViews
| Métodos | |
|---|---|
query |
GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query Oferece a capacidade de consultar (receber, filtrar e segmentar) um relatório de links de desempenho de propriedade de uma conta específica. |
Recurso REST: v3.accounts.reconciliationReports
| Métodos | |
|---|---|
create |
POST /v3/{parent=accounts/*}/reconciliationReports Cria um relatório de reconciliação e faz upload dele no Google. |
get |
GET /v3/{name=accounts/*/reconciliationReports/*} Retorna um relatório de reconciliação. |
list |
GET /v3/{parent=accounts/*}/reconciliationReports Retorna uma lista dos nomes dos relatórios de reconciliação criados. |
validate |
POST /v3/{parent=accounts/*}/reconciliationReports:validate Valida um relatório de reconciliação. |