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
de 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
de 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
de GET /promotions/v1beta/{name=accounts/*/promotions/*} Recupera a promoção da sua conta do Merchant Center.
insert
de POST /promotions/v1beta/{parent=accounts/*}/promotions:insert Insere uma promoção na sua conta do Merchant Center.
list
de 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
de DELETE /products/v1beta/{name=accounts/*/productInputs/*} Exclui uma entrada de produto da sua conta do Merchant Center.
insert
de 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
de GET /products/v1beta/{name=accounts/*/products/*} Recupera o produto processado da sua conta do Merchant Center.
list
de 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
de POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions Cria uma inscrição de notificação para um comerciante.
delete
de DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*} Exclui a inscrição de notificação de um comerciante.
get
de GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*} Recebe inscrições de notificação de uma conta.
list
de GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions Recebe todas as inscrições de notificação de um comerciante.
patch
de PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*} Atualiza uma inscrição de notificação existente para um comerciante.

Recurso REST: lfp_v1beta.accounts.lfpInventories

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

Recurso REST: lfp_v1beta.accounts.lfpSales

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

Recurso REST: lfp_v1beta.accounts.lfpStores

Métodos
delete
de DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*} Exclui a loja de um comerciante de destino.
get
de GET /lfp/v1beta/{name=accounts/*/lfpStores/*} Recupera informações sobre uma loja.
insert
de POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert Insere uma loja para o comerciante de destino.
list
de 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
de DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*} Exclui o LocalInventory especificado do produto fornecido na sua conta do comerciante.
insert
de POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert Insere um recurso LocalInventory em um produto na sua conta de comerciante.
list
de 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
de DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*} Exclui o recurso RegionalInventory especificado do produto especificado na sua conta de comerciante.
insert
de POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert Insere um RegionalInventory em um determinado produto na sua conta do comerciante.
list
de 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
de POST /datasources/v1beta/{parent=accounts/*}/dataSources Cria a nova configuração de fonte de dados para a conta especificada.
delete
de DELETE /datasources/v1beta/{name=accounts/*/dataSources/*} Exclui uma fonte de dados da sua conta do Merchant Center.
fetch
de POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch Executa a busca de dados imediatamente (mesmo fora da programação) em uma fonte de dados da sua conta do Merchant Center.
get
de GET /datasources/v1beta/{name=accounts/*/dataSources/*} Recupera a configuração da fonte de dados da conta especificada.
list
de GET /datasources/v1beta/{parent=accounts/*}/dataSources Lista as configurações das fontes de dados da conta especificada.
patch
de PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*} Atualiza a configuração da fonte de dados atual.

Recurso REST: conversions_v1beta.accounts.conversionSources

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

Recurso REST: accounts_v1beta.accounts

Métodos
createAndConfigure
de POST /accounts/v1beta/accounts:createAndConfigure Cria uma conta independente do Merchant Center com configurações adicionais.
delete
de DELETE /accounts/v1beta/{name=accounts/*} Exclui a conta especificada, independentemente do tipo: independente, MCA ou subconta.
get
de GET /accounts/v1beta/{name=accounts/*} Recupera uma conta da sua conta do Merchant Center.
list
de 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
de GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts Liste todas as subcontas de uma determinada conta de múltiplos clientes.
patch
de PATCH /accounts/v1beta/{account.name=accounts/*} Atualiza uma conta independentemente do tipo: independente, MCA ou subconta.

Recurso REST: accounts_v1beta.accounts.accounttax

Métodos
get
de GET /accounts/v1beta/{name=accounts/*/accounttax/*} Retorna as regras fiscais que correspondem às condições de GetAccountTaxRequest
patch
de PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*} Atualiza as configurações de tributos da conta.

Recurso REST: accounts_v1beta.accounts.businessIdentity

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

Recurso REST: accounts_v1beta.accounts.businessInfo

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

Recurso REST: accounts_v1beta.accounts.emailpreferences

Métodos
getEmailPreferences
de GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences} Retorna as preferências de e-mail de um usuário da conta do Merchant Center.
updateEmailPreferences
de 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
de POST /accounts/v1beta/{name=accounts/*/homepage}:claim Reivindica a página inicial de uma loja.
getHomepage
de GET /accounts/v1beta/{name=accounts/*/homepage} Recupera a página inicial de uma loja.
unclaim
de POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim Cancela a reivindicação da página inicial de uma loja.
updateHomepage
de PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage} Atualiza a página inicial de uma loja.

Recurso REST: accounts_v1beta.accounts.issues

Métodos
list
de 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
de GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*} Recebe uma política de devolução existente.
list
de GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies Lista todas as políticas de devolução.

Recurso REST: accounts_v1beta.accounts.programs

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

Recurso REST: accounts_v1beta.accounts.regions

Métodos
create
de POST /accounts/v1beta/{parent=accounts/*}/regions Cria uma definição de região na sua conta do Merchant Center.
delete
de DELETE /accounts/v1beta/{name=accounts/*/regions/*} Exclui uma definição de região da sua conta do Merchant Center.
get
de GET /accounts/v1beta/{name=accounts/*/regions/*} Recupera uma região definida na sua conta do Merchant Center.
list
de GET /accounts/v1beta/{parent=accounts/*}/regions Lista as regiões na sua conta do Merchant Center.
patch
de 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
de GET /accounts/v1beta/{name=accounts/*/shippingSettings} Recuperar informações de configuração de frete.
insert
de POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert Substituir 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
de GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*} Retorna o estado de um contrato de Termos de Serviço.
retrieveForApplication
de 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
de POST /accounts/v1beta/{parent=accounts/*}/users Cria um usuário da conta do Merchant Center.
delete
de DELETE /accounts/v1beta/{name=accounts/*/users/*} Exclui um usuário da conta do Merchant Center.
get
de GET /accounts/v1beta/{name=accounts/*/users/*} Recupera um usuário da conta do Merchant Center.
list
de GET /accounts/v1beta/{parent=accounts/*}/users Lista todos os usuários de uma conta do Merchant Center.
patch
de PATCH /accounts/v1beta/{user.name=accounts/*/users/*} Atualiza um usuário da conta do Merchant Center.

Recurso REST: accounts_v1beta.termsOfService

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