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 exemplos de código em Java e .NET.

Neste guia, vamos 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 a REST

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

O restante desta documentação será escrito principalmente para Product, mas o processo deve ser semelhante para ProductCertification.

Configurar sua conta do Manufacturer Center

  1. Crie uma conta do Manufacturer Center.

  2. Não se esqueça de qual e-mail 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 do desenvolvedor sobre Accounts.Products.list.

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

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

  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 solicitação à API Manufacturer Center.

  6. Se você ainda não tiver produtos no Manufacturer Center, não haverá na lista. Agora, você pode pular para outras solicitações e ver o que elas fazem. Como se trata de uma API RESTful, todas as solicitações funcionam de maneira semelhante. Uma boa próxima etapa, quando você tiver 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 seu projeto no Console de APIs. Aqui presumimos que você vai acessar sua própria conta do Manufacturer Center. Portanto, sugerimos usar contas de serviço para simplificar o fluxo de autenticação. Consulte o guia de contas de serviço para ver detalhes sobre como configurar uma nova conta de serviço para usar 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 da conta de serviço à sua conta do Manufacturer Center, é possível acessá-la usando o código de amostra disponível. Este guia usa exemplos 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 página do GitHub.

  3. No subdiretório java, crie os exemplos de Java:

    $ mvn compile

  4. Agora, execute o código ProductsListSample (o exemplo de ProductCertification 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 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 adequadas. O arquivo JSON salvo 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 dizer ao código onde seu arquivo está definindo a seguinte variável de ambiente.

    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 momento, o programa Java termina a execução e imprime uma lista de produtos encontrados ou uma mensagem informando que não havia produtos na sua conta. Se você receber um erro, como "O usuário não pode acessar a conta 1234567890", é provável que você não tenha configurado o usuário da conta de serviço como 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, a solicitação seria rejeitada.

  8. É possível executar ProductsListSample quantas vezes você quiser, já que essa é uma solicitação somente leitura. Também é possível explorar os outros exemplos criados para Java e .NET.