rocket
Conoce la
API de Merchant
(el sucesor oficial de Content API for Shopping).
update
Obtén las últimas novedades
sobre las nuevas funciones, las correcciones de errores y las actualizaciones de la API de Merchant.
add_alert
Nota: Content API for Shopping dejará de estar disponible el 18 de agosto de 2026.
Cuentas de servicio
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Las cuentas de servicio son Cuentas de Google especiales que las aplicaciones pueden usar para acceder a las APIs de Google de manera programática a través de OAuth 2.0. Una cuenta de servicio usa un flujo de OAuth 2.0 que no requiere autorización humana.
En su lugar, usa un archivo de claves al que solo puede acceder tu aplicación. En esta guía, se explica cómo acceder a Content API for Shopping con cuentas de servicio.
Nota: Las aplicaciones que usan cuentas de servicio para la autenticación solo pueden acceder a tu propia cuenta de Merchant Center. Si estás escribiendo una aplicación de terceros que necesita acceso a las cuentas de Merchant Center de tus clientes, consulta la guía Autorizar solicitudes.
Requisitos previos
Pasos para usar una cuenta de servicio y acceder a Content API for Shopping
- Genera credenciales de cuenta de servicio o accede a las credenciales públicas
que ya generaste. Deberás crear un ID de cliente de OAuth 2.0 y obtener un archivo de clave privada *.json:
- Ve a la Consola de API de Google.
- Selecciona un proyecto en el menú desplegable que se encuentra en la parte superior de la página. Si aún no tienes uno, haz clic en PROYECTO NUEVO para crear uno.
- Si aún no habilitaste Content API for Shopping para
este proyecto, búscala en la lista de APIs de Google y habilítala.
- En la barra lateral izquierda, selecciona Credenciales.
Es posible que debas hacer clic en la flecha que apunta a la izquierda en la parte superior izquierda para ver esto.
- Para configurar una cuenta de servicio, selecciona CREAR CREDENCIALES y, luego, Cuenta de servicio.
- Asigna un nombre a la cuenta de servicio nueva. Esto también sirve como nombre de usuario predeterminado para el ID de la cuenta de servicio. Registra el ID de la cuenta de servicio, incluida la parte después del carácter "@", para usarlo más adelante. Haz clic en CREAR, sigue los pasos opcionales para otorgar acceso al proyecto y a los usuarios y haz clic en LISTO.
La elección del rol para la cuenta de servicio no tendrá ningún efecto en las llamadas que se pueden realizar a Content API, ya que el acceso a los métodos de Content API se determina por el rol asociado con el ID de cuenta de servicio en Merchant Center. Si no sabes qué elegir, selecciona Project > Viewer.
- Se te dirigirá a la página Cuentas de servicio, donde podrás acceder a tu cuenta de servicio nueva.
- Para obtener una clave privada JSON, haz clic en la cuenta de servicio y, luego, en la pestaña CLAVES. Haz clic en AGREGAR CLAVE > Crear clave nueva y, luego, selecciona JSON como el tipo de clave. Haz clic en CREATE para descargar la clave privada en tu computadora.
- Agrega la nueva cuenta de servicio como usuario a tu cuenta de Merchant Center. Si eres un desarrollador externo, deberás pedirle a tu cliente que realice este paso por ti.
- Ve a tu cuenta de Merchant Center.
- Ve a Acceso a la cuenta en la configuración de tu cuenta de Merchant Center.
- Haz clic en + Agregar usuario y usa el ID de la cuenta de servicio como la dirección de correo electrónico del usuario nuevo.
Si no tomaste nota del ID de la cuenta de servicio antes, ve a la página de administración Cuentas de servicio y selecciona el proyecto que creaste.
- Especifica las preferencias de Acceso de usuarios y Notificaciones por correo electrónico para la cuenta de servicio. Ten en cuenta que el uso del servicio
Accounts requiere acceso de administrador.
- Haz clic en Agregar usuario para guardar las preferencias y volver a la lista de usuarios. El ID de la cuenta de servicio debe aparecer en la lista con el rol de usuario elegido.
- Repite el proceso para todas las demás cuentas de servicio que quieras agregar.
- Ahora puedes acceder a tu cuenta de Merchant Center con la cuenta de servicio, ya sea mediante el flujo de Credenciales predeterminadas de la aplicación de Google o directamente con el flujo de la cuenta de servicio. En los ejemplos de Content API for Shopping, se muestra cómo usar ambos flujos para las credenciales de la cuenta de servicio en cada lenguaje de programación compatible.
Consulta las muestras de código para probar tu cuenta de servicio nueva y aprender qué cambios deberás realizar para usar cuentas de servicio en tu propio código.
Preguntas frecuentes
- ¿Puedo acceder a la IU de Merchant Center con mi cuenta de servicio?
- No, las cuentas de servicio no son Cuentas de Google normales y no pueden acceder a la IU de Merchant Center.
- ¿Con qué frecuencia debo actualizar los tokens de acceso de la cuenta de servicio?
- Los tokens de acceso vencen una hora después de que el servidor de autorización de OAuth 2.0 de Google los emite. Cuando vence un token de acceso, la aplicación debe usar la biblioteca cliente para recuperar otro token de acceso.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-29 (UTC)
[null,null,["Última actualización: 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."]]
