Começar

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A API Manufacturer Center 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 programação, há algumas coisas que você precisa fazer.

Configurar sua conta do Manufacturer Center

  1. Crie uma conta do Manufacturer Center.
  2. Lembre-se do e-mail que você usou para criar essa conta do Manufacturer Center. Você vai precisar dele mais tarde. Nas capturas de tela, você o verá 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 para 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 a opção Google OAuth 2.0 está selecionada no menu suspenso Authentication:

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

    Observação: se você nunca concedeu a permissão OAuth2, precisará autorizar a chamada.

  5. A resposta deve indicar que o teste foi bem-sucedido. Parabéns! Você fez sua primeira solicitação à API do 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. Recomendamos fazer o Accounts.Products.get assim que você tiver produtos.

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ê acesse sua própria conta do Manufacturer Center. Por isso, sugerimos o uso de contas de serviço para simplificar o fluxo de autenticação. Consulte o guia Contas de serviço para ver detalhes sobre como configurar uma nova conta de serviço para usar com a conta do Manufacturer Center.

Observação:se você quiser fazer chamadas em nome de clientes com contas próprias do Manufacturer Center, consulte o guia Autorizar solicitações.

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, acesse a conta 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 nossa página do GitHub.

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

    $ mvn compile
            

  4. Agora, execute o código ProductsListSample:

    $ 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 acompanham 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ê transferiu por download durante a configuração da conta de serviço precisa ser colocado nesse diretório com o nome de arquivo service-account.json.

  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 precisa terminar de executar e imprimir uma lista de produtos que encontrou ou uma mensagem de que não há produtos na sua conta. Se você receber um erro, como "quot;User não pode acessar a conta 1234567890" é mais provável que você 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, ela seria rejeitada.

  8. Você pode executar o ProductsListSample quantas vezes quiser, já que é uma solicitação somente leitura. Conheça também as outras amostras que criamos para Java e .NET.