rocket
Conheça
a
API Merchant
– a sucessora oficial da API Content for Shopping.
update
Fique por dentro
dos novos recursos, correções de bugs e atualizações da API Merchant.
add_alert
Observação: a API Content for Shopping será desativada em 18 de agosto de 2026.
Contas de serviço
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 via OAuth 2.0. Uma conta de serviço usa um fluxo do OAuth 2.0 que não requer autorização humana.
Em vez disso, ele usa um arquivo de chave que somente seu aplicativo pode acessar. Neste guia,
discutimos como acessar a API Content for Shopping usando contas de serviço.
Observação:os aplicativos que usam contas de serviço
para autenticação só podem acessar sua própria conta do Merchant Center. Se você estiver
programando um aplicativo de terceiros que precise de acesso às contas do Merchant
Center dos seus clientes, consulte o guia Autorização de solicitações.
Pré-requisitos
Etapas para usar uma conta de serviço para acessar a API Content para Shopping
- Gere credenciais de conta de serviço ou acesse as credenciais públicas
que você já gerou. Você vai precisar criar um ID do cliente OAuth 2.0 e
obter um arquivo de chave privada *.json:
- Vá para o Console de APIs do Google.
- Selecione um projeto no menu suspenso na parte superior da página. Se
você ainda não tiver um, crie um clicando em NOVO PROJETO.
- Se você ainda não ativou a API Content for Shopping para
esse projeto, procure-a na lista de APIs do Google e ative-a.
- Na barra lateral à esquerda, selecione Credenciais.
Talvez seja necessário clicar na seta apontando para a esquerda no canto superior esquerdo para conferir essa opção.
- Para configurar uma conta de serviço, selecione CRIAR CREDENCIAIS e, em seguida, Conta de serviço.
- 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. Registre o ID da conta de serviço, incluindo a parte após
o caractere "@", para uso posterior. Clique em CRIAR e siga as etapas opcionais para conceder acesso ao projeto e aos usuários. Em seguida, clique em CONCLUÍDO.
A escolha da função para a conta de serviço não vai
afetar as chamadas que podem ser feitas para a API Content, já que o acesso aos
métodos da API Content é determinado pela função associada ao
ID da conta de serviço no Merchant Center. Se você não tiver certeza do que escolher, selecione
Project > Viewer.
- Você será direcionado para a página "Contas de serviço" em que sua nova conta de serviço pode ser acessada.
- Para conseguir uma chave privada JSON, clique na conta de serviço e, em seguida, na guia CHAVES. Clique em ADICIONAR CHAVE > Criar nova chave e selecione JSON
como o tipo de chave. Clique em CRIAR para fazer o download da chave privada no seu computador.
- Adicione a nova conta de serviço como um usuário à sua conta do Merchant Center. Se você for um desenvolvedor
de terceiros, será necessário que seu cliente faça essa etapa para você.
- Acesse sua conta do Merchant Center.
- Acesse Acesso à conta nas configurações da sua conta do
Merchant Center.
- Clique em + Adicionar usuário e use o ID da conta de serviço como o endereço de e-mail do novo usuário.
Se você não anotou o ID da conta de serviço, acesse a página de administração Contas de serviço e selecione o projeto criado.
- Especifique as preferências de Acesso do usuário e Notificações por e-mail para a conta de serviço. O uso do
serviço
Accounts requer acesso de administrador.
- Clique em Adicionar usuário para salvar as preferências e retornar à lista
de usuários. O ID da conta de serviço precisa estar listado com o papel de usuário escolhido.
- Repita o processo para todas as outras contas de serviço que você quer
adicionar.
- Agora você pode acessar sua conta do Merchant Center usando a conta de serviço
com o fluxo de credenciais padrão do aplicativo
do Google ou com o fluxo da conta de serviço
diretamente. As Amostras da API Content for Shopping mostram como usar os dois
fluxos para credenciais da conta de serviço em cada linguagem de programação compatível.
Confira os exemplos de código para testar sua nova conta de serviço e
saber quais mudanças serão necessárias para usar contas de serviço no seu código.
Perguntas frequentes
- Posso fazer login na interface do Merchant Center com minha conta de serviço?
- Não, as contas de serviço não são contas normais do Google e não podem acessar a
interface do Merchant 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 expirar, o aplicativo precisará usar
a biblioteca de cliente para buscar outro token de acesso.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eService accounts enable applications to programmatically access Google APIs, including the Content API for Shopping, using OAuth 2.0 without human intervention.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize service accounts, you need to generate service account credentials, add the service account as a user in your Merchant Center account, and then access your Merchant Center account using either the Google Application Default Credentials flow or the service account flow.\u003c/p\u003e\n"],["\u003cp\u003eApplications authenticated with service accounts can only access your own Merchant Center account; for third-party applications needing access to client accounts, refer to the Authorizing Requests guide.\u003c/p\u003e\n"],["\u003cp\u003eService accounts cannot be used to sign in to the Merchant Center UI and access tokens expire after one hour, requiring the application to fetch a new one using the client library.\u003c/p\u003e\n"]]],["Service accounts allow applications to access the Content API for Shopping programmatically. Key actions include: generating service account credentials by creating an OAuth 2.0 Client ID and a JSON private key file via the Google API Console, and adding the service account as a user within the Merchant Center account, specifying access and notification preferences. To access the Merchant center, you can use Google Application Default Credentials or a service account flow, with example code available. Access tokens expire hourly, requiring renewal.\n"],null,["# Service accounts are special Google accounts that can be used by\napplications to access Google APIs programmatically via OAuth 2.0. A service\naccount uses an OAuth 2.0 flow that does not require human authorization.\nInstead, it uses a key file that only your application can access. This guide\ndiscusses how to access the Content API for Shopping with service accounts.\n\n**Note:** Applications using service accounts\nfor authentication can only access your own Merchant Center account. If you are\nwriting a third-party application that needs access to your clients' Merchant\nCenter accounts, please see the [Authorizing Requests](/shopping-content/guides/how-tos/authorizing)\nguide instead.\n\nPrerequisites\n-------------\n\n- A [Merchant Center](//merchants.google.com/) account.\n\nSteps to using a service account to access the Content API for Shopping\n-----------------------------------------------------------------------\n\n1. Generate service account credentials or access the public credentials you've already generated. You will need to create an OAuth 2.0 Client ID and obtain a \\*.json private key file:\n 1. Go to the [Google API Console](https://console.cloud.google.com/apis/library).\n 2. Select a project in the drop-down menu at the top of the page. If you do not have one yet, create one by clicking **NEW PROJECT**.\n 3. If you have not already enabled the Content API for Shopping for this project, then search for it in the list of Google APIs and enable it.\n 4. In the sidebar on the left, select **Credentials**. You may need to click the left-pointing arrow at the top left to see this.\n 5. To set up a service account, select **CREATE CREDENTIALS** , and then **Service account** . \n 6. Name the new service account. This also serves as the default username for the service account ID. Record the service account ID, including the part after the '@' character, for later use. Click **CREATE** , then go through the optional steps of granting access to project and users, and click **DONE** .\n\n The choice of role for the service account will not\n have any effect on what calls can be made to the Content API, as access to\n Content API methods is determined instead by the role associated with the\n service account ID in Merchant Center. If you are unsure what to pick, just\n pick **Project \\\u003e Viewer**.\n 7. You will be directed to the Service Accounts page where your new service account can be accessed.\n 8. To obtain a JSON private key, click on the service account, then the **KEYS** tab. Click **ADD KEY \\\u003e Create new key** and then select JSON as the key type. Click **CREATE** to download the private key to your computer.\n2. Add the new service account as a user to your Merchant Center account. If you are a third-party developer, you will need to have your client do this step for you.\n 1. Go to your [Merchant\n Center account](//merchants.google.com/).\n 2. Go to **Account Access** in the settings of your Merchant Center account.\n 3. Click **+ Add user** and use the service account ID as the email address for the new user.\n\n If you did not take note of the\n service account ID earlier, go to the [Service\n Accounts](//console.developers.google.com/iam-admin/serviceaccounts/) administration page and select the project you created.\n 4. Specify the **User access** and **Email notifications** preferences for the service account. Note that the use of the `Accounts` service requires **Admin** access.\n 5. Click **Add user** to save preferences and be returned to the list of users. The service account ID should be listed with the chosen user role.\n 6. Repeat the process for all other service accounts you want to add.\n3. Now you can access your Merchant Center account using the service account either by using the [Google Application\n Default Credentials](/identity/protocols/application-default-credentials) flow or by using the [service account flow](/identity/protocols/OAuth2ServiceAccount) directly. The Content API for Shopping [Samples](/shopping-content/guides/libraries) show how to use both flows for service account credentials in each supported programming language. Please check out the code samples to try out your new service account and to learn what changes you will need to use service accounts in your own code.\n\nFrequently asked questions\n--------------------------\n\nCan I sign in to the Merchant Center UI with my service account?\n: No, service accounts are not regular Google accounts and cannot access the\n Merchant Center UI.\n\nHow often do I need to refresh service account access tokens?\n: Access tokens expire one hour after they are issued by the Google OAuth 2.0\n Authorization Server. When an access token expires, the application should use\n the client library to fetch another access token."]]
