Merchant API

Gerenciar suas contas do Merchant Center de forma programática.

Serviço: merchantapi.googleapis.com

Para chamar esse serviço, recomendamos que você use as bibliotecas de cliente fornecidas pelo Google. Caso seu aplicativo precise usar suas próprias bibliotecas 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 IDE e outras ferramentas que interagem com as APIs do Google. Um serviço pode fornecer vários documentos de descoberta. Este serviço apresenta os documentos de descoberta abaixo:

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://merchantapi.googleapis.com

Recurso REST: reviews_v1beta.accounts.merchantReviews

Métodos
delete DELETE /reviews/v1beta/{name=accounts/*/merchantReviews/*}
Exclui a avaliação do comerciante.
get GET /reviews/v1beta/{name=accounts/*/merchantReviews/*}
Recebe uma avaliação do comerciante.
insert POST /reviews/v1beta/{parent=accounts/*}/merchantReviews:insert
Insere uma avaliação na sua conta do Merchant Center.
list GET /reviews/v1beta/{parent=accounts/*}/merchantReviews
Lista as avaliações do comerciante.

Recurso REST: reviews_v1beta.accounts.productReviews

Métodos
delete DELETE /reviews/v1beta/{name=accounts/*/productReviews/*}
Exclui uma avaliação de produto.
get GET /reviews/v1beta/{name=accounts/*/productReviews/*}
Recebe uma avaliação do produto.
insert POST /reviews/v1beta/{parent=accounts/*}/productReviews:insert
Insere uma avaliação de produto.
list GET /reviews/v1beta/{parent=accounts/*}/productReviews
Lista as avaliações do produto.

Recurso REST: reports_v1beta.accounts.reports

Métodos
search POST /reports/v1beta/{parent=accounts/*}/reports:search
Recupera um relatório definido por uma consulta de pesquisa.

Recurso REST: quota_v1beta.accounts.quotas

Métodos
list GET /quota/v1beta/{parent=accounts/*}/quotas
Lista a cota de chamadas diárias e o uso por grupo da sua conta do Merchant Center.

Recurso REST: promotions_v1beta.accounts.promotions

Métodos
get GET /promotions/v1beta/{name=accounts/*/promotions/*}
Recupera a promoção da sua conta do Merchant Center.
insert POST /promotions/v1beta/{parent=accounts/*}/promotions:insert
Insere uma promoção na sua conta do Merchant Center.
list GET /promotions/v1beta/{parent=accounts/*}/promotions
Lista as promoções na sua conta do Merchant Center.

Recurso REST: products_v1beta.accounts.productInputs

Métodos
delete DELETE /products/v1beta/{name=accounts/*/productInputs/*}
Exclui uma entrada de produto da sua conta do Merchant Center.
insert POST /products/v1beta/{parent=accounts/*}/productInputs:insert
Faz o upload de uma entrada de produto na sua conta do Merchant Center.

Recurso REST: products_v1beta.accounts.products

Métodos
get GET /products/v1beta/{name=accounts/*/products/*}
Recupera o produto processado da sua conta do Merchant Center.
list GET /products/v1beta/{parent=accounts/*}/products
Lista os produtos processados na sua conta do Merchant Center.

Recurso REST: notifications_v1beta.accounts.notificationsubscriptions

Métodos
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Cria uma assinatura de notificação para uma empresa.
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Exclui uma assinatura de notificação de um comerciante.
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Recebe as assinaturas de notificação de uma conta.
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
Recebe todas as assinaturas de notificação de um comerciante.
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
Atualiza uma assinatura de notificação de um comerciante.

Recurso REST: lfp_v1beta.accounts.lfpInventories

Métodos
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
Insere um recurso LfpInventory para a conta de comerciante de destino.

Recurso REST: lfp_v1beta.accounts.lfpSales

Métodos
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
Insere um LfpSale para o comerciante especificado.

Recurso REST: lfp_v1beta.accounts.lfpStores

Métodos
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
Exclui uma loja de um comerciante de destino.
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
Recupera informações sobre uma loja.
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
Insere uma loja para o comerciante de destino.
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
Lista as lojas do comerciante de destino, especificadas pelo filtro em ListLfpStoresRequest.

Recurso REST: inventories_v1beta.accounts.products.localInventories

Métodos
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
Exclui o LocalInventory especificado do produto na sua conta de comerciante.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
Insere um recurso LocalInventory em um produto na sua conta do comerciante.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
Lista os recursos LocalInventory do produto na sua conta de comerciante.

Recurso REST: inventories_v1beta.accounts.products.regionalInventories

Métodos
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
Exclui o recurso RegionalInventory especificado do produto na sua conta de comerciante.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
Insere um RegionalInventory em um determinado produto na sua conta do comerciante.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
Lista os recursos RegionalInventory do produto na sua conta de comerciante.

Recurso REST: datasources_v1beta.accounts.dataSources

Métodos
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
Cria a nova configuração da fonte de dados para a conta.
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
Exclui uma origem de dados da sua conta do Merchant Center.
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
Faz a busca de dados imediatamente (mesmo fora da programação de busca) em uma fonte de dados da sua conta do Merchant Center.
get GET /datasources/v1beta/{name=accounts/*/dataSources/*}
Recupera a configuração da fonte de dados para a conta especificada.
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
Lista as configurações das fontes de dados da conta.
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
Atualiza a configuração da fonte de dados atual.

Recurso REST: datasources_v1beta.accounts.dataSources.fileUploads

Métodos
get GET /datasources/v1beta/{name=accounts/*/dataSources/*/fileUploads/*}
Recebe o upload de arquivo da fonte de dados mais recente.

Recurso REST: conversions_v1beta.accounts.conversionSources

Métodos
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
Cria uma nova origem de conversão.
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
Arquiva uma origem de conversão.
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
Busca uma origem da conversão.
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
Recupera a lista de origens de conversão a que o autor da chamada tem acesso.
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
Atualiza as informações de uma origem de conversão.
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
Reativa uma origem de conversão arquivada.

Recurso REST: accounts_v1beta.accounts

Métodos
createAndConfigure POST /accounts/v1beta/accounts:createAndConfigure
Cria uma conta independente do Merchant Center com uma configuração extra.
delete DELETE /accounts/v1beta/{name=accounts/*}
Exclui a conta especificada, independentemente do tipo: independente, MCA ou subconta.
get GET /accounts/v1beta/{name=accounts/*}
Recupera uma conta da sua conta do Merchant Center.
list GET /accounts/v1beta/accounts
Lista as contas acessíveis pelo usuário que fez a chamada e que correspondem às restrições da solicitação, como tamanho da página ou filtros.
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
Lista todas as subcontas de uma determinada conta de múltiplos clientes.
patch PATCH /accounts/v1beta/{account.name=accounts/*}
Atualiza uma conta, independentemente do tipo: independente, MCA ou subconta.

Recurso REST: accounts_v1beta.accounts.autofeedSettings

Métodos
getAutofeedSettings GET /accounts/v1beta/{name=accounts/*/autofeedSettings}
Recupera as configurações de alimentação automática de uma conta.
updateAutofeedSettings PATCH /accounts/v1beta/{autofeedSettings.name=accounts/*/autofeedSettings}
Atualiza as configurações de alimentação automática de uma conta.

Recurso REST: accounts_v1beta.accounts.businessIdentity

Métodos
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
Recupera a identidade comercial de uma conta.
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
Atualiza a identidade comercial de uma conta.

Recurso REST: accounts_v1beta.accounts.businessInfo

Métodos
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
Recupera as informações comerciais de uma conta.
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
Atualiza as informações comerciais de uma conta.

Recurso REST: accounts_v1beta.accounts.emailPreferences

Métodos
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
Retorna as preferências de e-mail de um usuário da conta do Merchant Center.
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
Atualiza as preferências de e-mail de um usuário da conta do Merchant Center.

Recurso REST: accounts_v1beta.accounts.homepage

Métodos
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
Reivindica a página inicial de uma loja.
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
Recupera a página inicial de uma loja.
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
Cancela a reivindicação da página inicial de uma loja.
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
Atualiza a página inicial de uma loja.

Recurso REST: accounts_v1beta.accounts.issues

Métodos
list GET /accounts/v1beta/{parent=accounts/*}/issues
Lista todos os problemas da conta do Merchant Center.

Recurso REST: accounts_v1beta.accounts.onlineReturnPolicies

Métodos
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
Busca uma política de devolução atual para um determinado comerciante.
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
Lista todas as políticas de devolução de um determinado comerciante.

Recurso REST: accounts_v1beta.accounts.programs

Métodos
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
Desative a participação no programa especificado para a conta.
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
Permitir a participação no programa especificado para a conta.
get GET /accounts/v1beta/{name=accounts/*/programs/*}
Recupera o programa especificado para a conta.
list GET /accounts/v1beta/{parent=accounts/*}/programs
Recupera todos os programas da conta.

Recurso REST: accounts_v1beta.accounts.regions

Métodos
create POST /accounts/v1beta/{parent=accounts/*}/regions
Cria uma definição de região na sua conta do Merchant Center.
delete DELETE /accounts/v1beta/{name=accounts/*/regions/*}
Exclui uma definição de região da sua conta do Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/regions/*}
Recupera uma região definida na sua conta do Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/regions
Lista as regiões na sua conta do Merchant Center.
patch PATCH /accounts/v1beta/{region.name=accounts/*/regions/*}
Atualiza uma definição de região na sua conta do Merchant Center.

Recurso REST: accounts_v1beta.accounts.shippingSettings

Métodos
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
Recuperar informações de configuração de frete.
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
Substitua a configuração de frete de um comerciante pela configuração de frete de solicitação.

Recurso REST: accounts_v1beta.accounts.termsOfServiceAgreementStates

Métodos
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
Retorna o estado de um contrato de Termos de Serviço.
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
Recupera o estado do contrato para os Termos de Serviço do aplicativo.

Recurso REST: accounts_v1beta.accounts.users

Métodos
create POST /accounts/v1beta/{parent=accounts/*}/users
Cria um usuário da conta do Merchant Center.
delete DELETE /accounts/v1beta/{name=accounts/*/users/*}
Exclui um usuário da conta do Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/users/*}
Recupera um usuário da conta do Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/users
Lista todos os usuários de uma conta do Merchant Center.
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
Atualiza um usuário da conta do Merchant Center.

Recurso REST: accounts_v1beta.termsOfService

Métodos
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
Aceita um TermsOfService.
get GET /accounts/v1beta/{name=termsOfService/*}
Recupera o TermsOfService associado à versão fornecida.
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
Recupera a versão mais recente do TermsOfService para um determinado kind e region_code.