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 identificador exclusivo da conta e online~en~US~sku123 é o identificador exclusivo do 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 URL a seguir.

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Por exemplo, veja como criar 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 o gRPC ou o REST

A API Merchant oferece suporte a gRPC e REST. Há duas maneiras de fazer chamadas da API Merchant:

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 mais informações sobre como receber suporte, consulte Receber 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.
• Exemplos e bibliotecas:use o botão New issue (novo problema) no GitHub.

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