Como usar contas de serviço do OAuth 2.0 com a API Manufacturer Center
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As contas de serviço são Contas do Google especiais que podem ser usadas por aplicativos para acessar as APIs do Google de maneira programática por meio do OAuth 2.0. Uma conta de serviço usa um fluxo do OAuth 2.0 que não requer autorização adicional. Em vez disso, ele usa um arquivo de chave que somente seu aplicativo pode acessar. Neste guia, explicamos como
acessar a API Manufacturer Center com contas de serviço.
Etapas para usar uma conta de serviço para acessar a API Manufacturer Center
Gere credenciais de conta de serviço ou acesse as credenciais públicas que você
já gerou. Será necessário criar um ID do cliente OAuth 2.0 e receber um arquivo *.json de chave privada:
Selecione um projeto no menu suspenso na parte superior da página. Se ainda não tiver um, clique em Criar projeto.
Se você ainda não ativou a API Manufacturer Center para este projeto, pesquise-a na lista de APIs do Google e ative-a.
Na barra lateral à esquerda, selecione Credenciais.
Para configurar uma conta de serviço, selecione Criar credenciais e, em seguida,
Chave da conta de serviço.
Na página seguinte, selecione Nova conta de serviço na lista suspensa.
Nomeie a nova conta de serviço. Ele
também serve como o nome de usuário padrão do ID da conta de serviço. Lembre-se do ID da conta de serviço para usar mais tarde.
Selecione JSON para o tipo de chave e clique em Criar.
O botão Criar mudará para Criando... e, após a conclusão da geração da chave, será feito o download automático da chave privada como um arquivo *.json.
Você retornará à página "Credenciais" e verá a nova conta de serviço na lista de chaves da sua conta.
Adicione a nova conta de serviço como um usuário à sua conta do Manufacturer Center.
Se você for um desenvolvedor terceirizado, peça para seu cliente realizar
essa etapa por você.
Acesse a lista "Usuários" nas configurações da sua conta do Manufacturer Center.
Clique no botão "+Usuário" e use o ID da conta de serviço como o endereço de e-mail do novo usuário.
Preencha o formulário com o ID da conta de serviço e selecione os papéis do usuário desejados. Pelo menos um precisa ser escolhido, e o uso do serviço Accounts exige o papel de administrador.
Se você não anotou o ID da conta de serviço anteriormente, acesse a página de administração Contas de serviço e selecione o projeto criado.
Clique no botão Salvar. Você retornará à lista de usuários, e o ID da conta de serviço deve estar listado com os papéis do usuário escolhidos.
Repita o processo para todas as outras contas de serviço que você quer adicionar.
Para ver os usuários da conta de serviço, acesse a guia "Usuários". Eles
serão usuários com um endereço de e-mail terminado em "gserviceaccount.com".
Agora você pode acessar sua conta do Manufacturer Center com a conta de
serviço usando o fluxo de Application Default Credentials
do Google ou
o fluxo da conta de serviço
diretamente. As Amostras da API Manufacturer Center
mostram como usar os dois fluxos de credenciais da conta de serviço em cada linguagem de
programação compatível. Consulte os exemplos de código para testar sua nova conta de serviço e saber quais alterações serão necessárias para usar contas de serviço no seu próprio código.
Perguntas frequentes
Posso fazer login na interface do usuário da Web do Manufacturer Center com minha conta de serviço?
Não, as contas de serviço não são Contas do Google normais e não podem acessar a interface do usuário da Web do Manufacturer Center.
Com que frequência preciso atualizar os tokens de acesso da conta de serviço?
Os tokens de acesso expiram uma hora após serem emitidos pelo servidor de autorização do Google OAuth 2.0. Quando um token de acesso expira, o aplicativo deve usar a biblioteca de cliente para buscar outro token de acesso.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eService accounts enable applications to programmatically access the Manufacturer Center API using OAuth 2.0 without user intervention.\u003c/p\u003e\n"],["\u003cp\u003eTo use a service account, generate service account credentials in Google Cloud Console, enable the Manufacturer Center API, and download the JSON key file.\u003c/p\u003e\n"],["\u003cp\u003eAdd the service account as a user to your Manufacturer Center account with the appropriate role for API access.\u003c/p\u003e\n"],["\u003cp\u003eAccess your Manufacturer Center account programmatically using Google Application Default Credentials or the service account flow, referencing the provided samples.\u003c/p\u003e\n"],["\u003cp\u003eService accounts cannot be used to log into the Manufacturer Center web user interface but solely for API interaction.\u003c/p\u003e\n"]]],[],null,["# Using OAuth 2.0 service accounts with the Manufacturer Center API\n\nService accounts are special Google accounts that can be used by applications to\naccess Google APIs programmatically via OAuth 2.0. A service account uses an\nOAuth 2.0 flow that does not require additional authorization. Instead, it uses\na key file that only your application can access. This guide discusses how to\naccess the Manufacturer Center API with service accounts.\n| **Note:** Applications using service accounts for authentication can only access your own Manufacturer Center account. If you are writing a third-party application that needs access to your clients' Manufacturer Center accounts, see the [Authorizing Requests](/manufacturers/how-tos/authorizing) guide instead.\n\nPrerequisites\n-------------\n\n- A [Manufacturer Center](//manufacturers.google.com/) account.\n\nSteps to using a service account to access the Manufacturer Center API\n----------------------------------------------------------------------\n\n1. Generate service-account credentials or access the public credentials you've\n already generated. You will need to create an OAuth 2.0 Client ID and obtain\n a \\*.json private key file:\n\n 1. Go to the [Google API Console](https://console.cloud.google.com/apis/library).\n\n 2. Select a project in the drop-down menu at the top of the page. If you do\n not have one yet, create one by clicking **Create Project**.\n\n 3. If you have not already enabled the Manufacturer Center API for this\n project, then search for it in the list of Google APIs and enable it.\n\n 4. In the sidebar on the left, select **Credentials**.\n\n 5. To set up a service account, select **Create credentials** , and then\n **Service account key**.\n\n 1. On the next page, select **New service account** from the drop-down\n list.\n\n 2. Name the new service account. This\n also serves as the default username for the service account ID. Remember\n the service account ID for use later.\n\n | **Note:** The choice of role for the service account will not have any effect on what calls can be made to the Manufacturer Center API, as access to Manufacturer Center API methods is determined instead by the role associated with the service account ID in Manufacturer Center. If you are unsure what to pick, just pick Project►Viewer.\n\n 1. Select **JSON** for the key type, then click **Create**.\n\n 2. The **Create** button will change to **Creating...**, and once the key\n generation finishes, it will automatically download the private key as a\n \\*.json file.\n\n | **Important:** Protect the \\*.json key file that allows a service account to access the Google services for which it has been authorized. It is good practice to allow service accounts to only access one Google API each. This is a preventative measure to mitigate the amount of data an attacker can access in the situation that the service account's \\*.json key file is compromised.\n 1. You will be returned to the Credentials page, and you should see the new service account in the list of service account keys for your account.\n2. Add the new service account as a user to your Manufacturer Center account.\n If you are a third party developer, you will need to have your client do\n this step for you.\n\n 1. Go to your [Manufacturer Center account](//manufacturers.google.com/).\n\n 2. Go to the 'Users' list in the settings of your Manufacturer Center\n account.\n\n 3. Click the +User button, and use the service account ID as the email\n address for the new user.\n\n 4. Fill in the form with the [service account ID](#service-account-name),\n and select the desired user role(s). At least one must be chosen, and\n use of the `Accounts` service requires the Admin role.\n\n If you did not take note of the service account ID earlier, go to the\n [Service Accounts](https://console.developers.google.com/iam-admin/serviceaccounts/)\n administration page and select the project you created.\n\n 1. Click on the **Save** button. You will be returned to the list of users,\n and the service account ID should be listed with the chosen user role(s).\n\n 2. Repeat the process for all other service accounts you want to add.\n\n 3. View existing service account users by going to the Users tab. These\n will be users with an email address ending in 'gserviceaccount.com'.\n\n3. Now you can access your Manufacturer Center account using the service\n account either by using the [Google Application Default\n Credentials](/identity/protocols/application-default-credentials) flow or by\n using the [service account flow](/identity/protocols/OAuth2ServiceAccount)\n directly. The Manufacturer Center API [Samples](/manufacturers/libraries)\n show how to use both flows for service account credentials in each supported\n programming language. See the code samples to try out your new service\n account and to learn what changes you will need to use service accounts in\n your own code.\n\nFrequently asked questions\n--------------------------\n\n#### Can I log into the Manufacturer Center web user interface with my service account?\n\nNo, service accounts are not regular Google accounts and cannot access the\nManufacturer Center web user interface.\n\n#### How often do I need to refresh service account access tokens?\n\nAccess tokens expire one hour after they are issued by the Google OAuth 2.0\nAuthorization Server. When an access token expires, the application should use\nthe client library to fetch another access token."]]
