Começar a usar a API Merchant

Ative a API Merchant no seu projeto do Cloud para começar.

Veja como usar a API Merchant:

Usar as bibliotecas de cliente

A API Merchant é composta por várias sub-APIs.

Cada sub-API tem exemplos de código e bibliotecas de cliente para ajudar você a começar.

Se você já usa a API Content for Shopping, consulte Compatibilidade da API Content for Shopping.

Enviar solicitações

A API Merchant usa nomes de recursos em vez de IDs para identificação. Um exemplo de nome de recurso para um produto pode ser accounts/123/products/online~en~US~sku123, em que 123 é o único identificador da conta, e online~en~US~sku123 é o identificador exclusivo do o produto.

Para operar em um recurso, envie solicitações para URLs no seguinte formato:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}:{method}

Observação: a parte :{method} é omitida para métodos padrão.

Por exemplo, esta solicitação exclui o inventário regional:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

Para criar um novo recurso, use o nome do recurso pai e o seguinte URL

POST https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name of parent}/{resource}

Por exemplo, é assim que você cria uma nova região para account/123

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

Consulte a documentação de referência da API Merchant para mais detalhes sobre serviços específicos.

Usar gRPC ou REST

A API do Merchant Center é compatível com gRPC e REST (link em inglês). Estes são os duas maneiras de fazer chamadas de API do comerciante:

gRPC (recomendado)	REST
Crie o corpo da solicitação como um buffer de protocolo. Envie o corpo da solicitação para o servidor com HTTP/2. Desserialize a resposta para um buffer de protocolo. Interprete os resultados.	Crie o corpo da solicitação como um objeto JSON. Envie para o servidor usando o HTTP 1.1. Desserialize a resposta como um objeto JSON. Interprete os resultados.

Observação: se você usar uma biblioteca de cliente, o mecanismo de transporte padrão será o gRPC. Na maioria dos casos, não é necessário fazer nada além de chamar os endpoints da API Merchant para usar o gRPC.

Ajuda

Para informações sobre como acessar o suporte, consulte Receba ajuda com a API Merchant.

Enviar feedback

O período Beta nos dá a oportunidade de coletar e abordar seu feedback antes da versão de disponibilidade geral. Para enviar feedback, siga um destes procedimentos:

• Recursos da API: envie o formulário de feedback.
• Documentação: use as classificações de polegar na página e o botão Enviar feedback.
• Amostras e bibliotecas:use o botão Novo problema no GitHub.

Para fornecer um feedback geral após a implementação de cada tarefa, use o formulário de feedback.