Merchant API

Gerencie programaticamente suas contas do Merchant Center.

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: 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 diária de chamadas 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 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 um comerciante.
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Exclui a assinatura de notificação de um comerciante.
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
Recebe inscrições 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 a inscrição 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 na conta do comerciante de destino especificada.

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 a 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 especificado na sua conta do 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 especificado na sua conta do 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 especificado 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 especificado na sua conta do comerciante.

Recurso REST: datasources_v1beta.accounts.dataSources

Métodos
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
Cria a nova configuração de fonte de dados para a conta especificada.
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
Exclui uma fonte de dados da sua conta do Merchant Center.
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
Executa 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 da conta especificada.
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
Lista as configurações das fontes de dados da conta especificada.
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
Atualiza a configuração da fonte de dados existente.

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 existente.
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
Busca uma origem de 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 existente.
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 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.
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
Recupera a identidade comercial de uma conta.
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
Recupera as informações comerciais de uma conta.
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
Recupera a página inicial de uma loja.
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
Recuperar informações de configuração de frete.
list GET /accounts/v1beta/accounts
Lista as contas acessíveis ao usuário que fez a chamada e correspondem às restrições da solicitação, como tamanho ou filtros da página.
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 de qualquer tipo: independente, MCA ou subconta.
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
Atualiza a identidade comercial de uma conta.
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
Atualiza as informações comerciais de uma conta.
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
Atualiza a página inicial de uma loja.

Recurso REST: accounts_v1beta.accounts.accounttax

Métodos
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}
Retorna as regras fiscais que correspondem às condições de GetAccountTaxRequest
list GET /accounts/v1beta/{parent=accounts/*}/accounttax
Lista as configurações de tributos das subcontas apenas na sua conta do Merchant Center.
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}
Atualiza as configurações de tributos da conta.

Recurso REST: accounts_v1beta.accounts.homepage

Métodos
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
Reivindica 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.

Recurso REST: accounts_v1beta.accounts.issues

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

Recurso REST: accounts_v1beta.accounts.onlineReturnPolicies

Métodos
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
Recebe uma política de devolução existente.
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
Lista todas as políticas de devolução atuais.

Recurso REST: accounts_v1beta.accounts.programs

Métodos
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
Desativa a participação no programa especificado para a conta.
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
Ativa 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
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
Substitua a configuração de frete de um comerciante pela configuração de frete da 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.
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
Retorna as preferências de e-mail de 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.
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.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.