Começar

A API Manufacturer Center (MfC) permite que os apps interajam diretamente com a plataforma do Manufacturer Center. Para ajudar você a começar, oferecemos amostras de código em Java e .NET.

Este guia ajudará você a criar seu primeiro aplicativo usando a API Manufacturer Center. Antes de começar a programar, há algumas coisas que você precisa fazer.

Suporte REST

Nossa API REST oferece suporte para operações básicas de CRUD para dois tipos de recursos:

O restante desta documentação será escrito principalmente para Produto, mas o processo é semelhante para ProductCertificate.

Configurar sua conta do Manufacturer Center

  1. Crie uma conta do Manufacturer Center.

  2. Não se esqueça do e-mail que você usou para criar essa conta do Manufacturer Center, porque você precisará dele mais tarde. Nas capturas de tela, ele será representado como manufacturer_user@example.com.

Faça sua primeira solicitação de API (sem uma linha de código)

  1. Acesse o APIs Explorer na documentação para desenvolvedores sobre Accounts.Products.list.

  2. Verifique se a Conta do Google conectada está listada na configuração "Usuários" na guia "Configurações".

  3. No APIs Explorer, verifique se o Google OAuth 2.0 está selecionado no menu suspenso Authentication:

  4. Insira accounts/{account_id}, substituindo {account_id} pelo ID do fabricante da sua conta do Manufacturer Center, no campo "pai" do formulário e clique em Executar.

  5. A resposta deve indicar que o teste foi bem-sucedido. Parabéns! Você fez sua primeira API da API Manufacturer Center.

  6. Se você ainda não tiver produtos no Manufacturer Center, não haverá nenhum na lista. Neste ponto, é possível pular para outras solicitações e ver o que elas fazem. Como essa é uma API RESTful, todas as solicitações funcionam de maneira semelhante. Uma boa próxima etapa, depois de ter os produtos, é testar Accounts.Products.get.

Criar um projeto do Console de APIs do Google

As solicitações para a API Manufacturer Center são feitas pelo projeto do Console de APIs. Aqui, presumimos que você acessará sua própria conta do Manufacturer Center. Por isso, sugerimos usar contas de serviço para simplificar o fluxo de autenticação. Consulte o guia de contas de serviço para mais detalhes sobre como configurar uma nova conta de serviço a ser usada com sua conta do Manufacturer Center.

Sua primeira solicitação de API autorizada usando Java

Agora que você configurou uma conta de serviço e adicionou o ID dela à sua conta do Manufacturer Center, é possível acessá-la usando o código de amostras disponível. Neste guia, usamos as amostras de Java para demonstrar o uso da API.

  1. Instale o Apache Maven, caso ainda não tenha feito isso.

  2. Faça o download das nossas amostras do Shopping na nossa página do GitHub.

  3. No subdiretório java, crie as amostras de Java:

    $ mvn compile

  4. Agora, execute o código ProductsListSample (o exemplo de ProductCertificate seria ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. Se você não tiver seguido as instruções de configuração no arquivo README que acompanha os arquivos de origem, receberá um erro informando que nenhuma configuração de amostra foi encontrada. Siga as instruções no README para criar o diretório de configuração e preenchê-lo com as informações apropriadas. O arquivo JSON que você salvou durante a configuração da conta de serviço precisa ser colocado nesse diretório com o nome de arquivo service-account.json. Lembre-se de informar o código do arquivo, definindo a variável de ambiente a seguir.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. Agora que você definiu a configuração de amostras, execute o código ProductsListSample novamente.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. Nesse ponto, o programa Java deve concluir a execução e imprimir uma lista de produtos que encontrou ou uma mensagem de que não havia produtos na sua conta. Se você receber um erro como "O usuário não consegue acessar a conta 1234567890", é mais provável que não tenha configurado o usuário da conta de serviço como um usuário autorizado no Manufacturer Center. Do ponto de vista da API, o projeto do Console de APIs enviou uma solicitação em nome de um usuário que não estava na lista de administradores autorizados do Manufacturer Center. Portanto, essa solicitação seria rejeitada.

  8. Você pode tentar executar ProductsListSample quantas vezes quiser, já que se trata de uma solicitação somente leitura. Você também pode explorar os outros exemplos que criamos para Java e .NET.