Neste guia, vamos ajudar você a criar seu primeiro aplicativo usando o 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:
Produto para proprietários de marca
e parceiros de dados.
Não se esqueça de qual e-mail você usou para criar o Manufacturer Center
porque você vai precisar dele mais tarde. Nas capturas de tela,
representado como manufacturer_user@example.com.
Faça sua primeira solicitação de API (sem uma linha de código)
Acesse as APIs
Análises no
nossa documentação do desenvolvedor para Accounts.Products.list.
Verifique se a Conta do Google conectada aparece na seção "Usuários". configuração
na guia "Configurações".
No APIs Explorer, verifique se Google OAuth 2.0 está selecionado na
Menu suspenso Autenticação:
Insira accounts/{account_id}, substituindo {account_id} pelo seu
ID do fabricante da sua conta do Manufacturer Center para o "pai"
campo do formulário e clique em Executar.
A resposta deve indicar que o teste foi bem-sucedido. Parabéns! Você criou
a primeira solicitação da API Manufacturer Center.
Se você ainda não tiver produtos no Manufacturer Center, não haverá nenhum
na lista. Agora, é possível passar para outras solicitações e analisar
o que eles fazem. Como essa é uma API RESTful, todas as solicitações funcionam de maneira semelhante. Um
Depois de ter os produtos, tente
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ê acessará seu próprio
do Manufacturer Center. Sugerimos usar service.
contas para simplificar a
pelo fluxo de autenticação. Consulte a seção Serviço
de contas para saber como
Configure 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 dela ao
sua conta do Manufacturer Center, é possível acessá-la usando o
Exemplos de código disponíveis. Este guia usa a biblioteca de cliente
para demonstrar usando a API.
Instale o Apache Maven, caso ainda não tenha feito isso.
Se você não seguiu as instruções de configuração no arquivo README,
que acompanham os arquivos de origem, você receberá um erro de que nenhuma amostra
configuração do Terraform. Siga as instruções no README para criar
diretório de configuração e preenchê-lo com as informações
informações imprecisas ou inadequadas. O arquivo JSON que você baixou durante a configuração do serviço
deve ser colocada nesse diretório com o nome de arquivo
service-account.json: Lembre-se de dizer ao código onde seu arquivo está
definindo a variável de ambiente a seguir.
Neste ponto, o programa Java termina a execução e mostra
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
1234567890", provavelmente você não configurou o
usuário da conta de serviço como um usuário autorizado no Manufacturer Center. Na guia
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 parceiros autorizados do Manufacturer Center
administradores, então essa solicitação, obviamente, seria rejeitada.
Você pode executar o ProductsListSample quantas vezes quiser
quer, já que é uma solicitação somente leitura. Você também pode explorar os outros
que criamos para Java e .NET.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThe Manufacturer Center API allows direct interaction with the Manufacturer Center platform, offering code samples in Java and .NET to facilitate application development.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, you need to set up a Manufacturer Center account and make an initial API request using the API Explorer to authorize access.\u003c/p\u003e\n"],["\u003cp\u003eA Google API Console project with a service account is necessary to make requests to the Manufacturer Center API, enabling secure communication.\u003c/p\u003e\n"],["\u003cp\u003eYou can access your Manufacturer Center account using provided sample code (e.g., Java samples) after configuring a service account and adding it as an authorized user.\u003c/p\u003e\n"],["\u003cp\u003eThe samples demonstrate various API functionalities, including listing products and performing other read-only operations, allowing for experimentation and further exploration.\u003c/p\u003e\n"]]],[],null,["# Get Started\n\nThe Manufacturer Center (MfC) API allows apps to interact directly with the\n[Manufacturer Center platform](https://manufacturers.google.com). To help you\nget started, we offer [code samples](/manufacturers/libraries) in Java and .NET.\n\nThis guide will help you create your first application using the Manufacturer\nCenter API. Before you can start coding, there are a few things you need to do.\n\nREST Support\n------------\n\nOur REST API supports basic CRUD operations for 2 different types of resources:\n\n- [Product](/manufacturers/reference/rest/v1/accounts.products) for Brand Owners and Data Partners.\n- And [ProductCertification](/manufacturers/reference/rest/v1/accounts.languages.productCertifications) for Certification Bodies.\n\nThe rest of this documentation will be written mainly for [Product](/manufacturers/reference/rest/v1/accounts.products) but the process should be similar for [ProductCertification](/manufacturers/reference/rest/v1/accounts.languages.productCertifications).\n\nSet up your Manufacturer Center Account\n---------------------------------------\n\n1. Create a [Manufacturer Center\n Account](//support.google.com/manufacturers/answer/7064831).\n\n | **Note:** Certification Body users can't create an account this way but need to contact our support directly.\n2. Be sure to remember which email you used to create this Manufacturer Center\n account, as you will need that later. In the screenshots, you'll see it\n represented as **manufacturer_user@example.com**.\n\nMake your first API request (without a line of code!)\n-----------------------------------------------------\n\n1. Head over to the [APIs\n Explorer](/manufacturers/reference/rest/v1/accounts.products/list#try-it) in\n our developer documentation for `Accounts.Products.list`.\n\n2. Ensure that the logged in Google account is listed in the 'Users' setting\n in the Settings tab.\n\n3. In the APIs Explorer, make sure that **Google OAuth 2.0** is selected in the\n **Authentication** drop-down menu:\n\n4. Enter `accounts/{account_id}`, replacing `{account_id}` with your\n Manufacturer ID from your Manufacturer Center account, into the 'parent'\n field of the form, and click **Execute**.\n\n | **Note:** If you have not previously granted OAuth2 permission, you will now be asked to authorize the call.\n5. You should see a successful response. Congratulations! You've made your\n first Manufacturer Center API request.\n\n6. If you have no products in your Manufacturer Center yet, there won't be any\n in the list. At this point, you can hop to other requests and take a look at\n what they do. Since this is a RESTful API, all requests work similarly. A\n good next step, once you have products, is to try\n [`Accounts.Products.get`](/manufacturers/reference/rest/v1/accounts.products/get#try-it).\n\nCreate a Google API Console Project\n-----------------------------------\n\nRequests to the Manufacturer Center API are made through your API Console project. Here we assume you will be accessing your own\nManufacturer Center account, so we suggest using [service\naccounts](/identity/protocols/OAuth2ServiceAccount) to simplify the\nauthentication flow. See the [Service\nAccounts](/manufacturers/how-tos/service-accounts) Guide for details on how to\nset up a new service account to use with your Manufacturer Center account.\n| **Note:** If you are interested in making calls on behalf of clients with their own Manufacturer Center accounts, then see the [Authorize\n| Requests](/manufacturers/how-tos/authorizing) guide.\n\nYour first authorized API request using Java\n--------------------------------------------\n\nNow that you've set up a service account and added the service account ID to\nyour Manufacturer Center account, you can access your account using the\navailable [Samples code](/manufacturers/libraries). This guide uses the Java\nsamples to demonstrate using the API.\n\n1. Install [Apache Maven](https://maven.apache.org/), if you haven't already.\n\n2. Download our [Shopping\n samples](//github.com/googleads/googleads-shopping-samples/) from our GitHub\n page.\n\n3. From within the `java` subdirectory, build the Java samples:\n\n $ mvn compile\n\n4. Now run the `ProductsListSample` (the example for [ProductCertification](/manufacturers/reference/rest/v1/accounts.languages.productCertifications) would be `ListProductCertificationsSample`) code:\n\n $ mvn exec:java -Dexec.mainClass=\"shopping.manufacturers.v1.samples.products.ProductsListSample\"\n\n5. If you haven't followed the configuration directions in the README\n accompanying the source files, you will get an error that no sample\n configuration could be found. Follow the directions in the README to create\n the configuration directory and to populate it with the appropriate\n information. The JSON file you downloaded while setting up your service\n account should be placed in that directory with the filename\n `service-account.json`. Remember to tell the code where your file is by\n setting the following environment variable.\n\n export GOOGLE_APPLICATION_CREDENTIALS=\u003cPath to your JSON credentials file\u003e\n\n6. Now that you have set up the samples configuration, run the\n `ProductsListSample` code again.\n\n $ mvn exec:java -Dexec.mainClass=\"shopping.manufacturers.v1.samples.products.ProductsListSample\"\n\n7. At this point, the Java program should finish executing, and print out\n either a list of products that it found, or a message that there were no\n products in your account. If you get an error such as \"User cannot access\n account 1234567890\", it's most likely because you have not set up the\n service account user as an authorized user in Manufacturer Center. From the\n API's standpoint, the API Console project sent a request on\n behalf of a user who was not on the list of authorized Manufacturer Center\n administrators, so it would, of course, reject that request.\n\n8. You can experiment with running `ProductsListSample` as many times as you\n want, since it is a read-only request. You can also explore the other\n samples that we've created for both Java and .NET."]]
