A cada token de desarrollador de la API de Google Ads se le asigna un nivel de acceso y un "uso permitido". El nivel de acceso determina si puedes afectar las cuentas de producción y la cantidad de operaciones y solicitudes que puedes ejecutar diariamente. El uso permitido determina las funciones específicas de la API de Google Ads que el token de desarrollador puede usar.
Niveles de acceso
En la tabla, se indican cuatro niveles de acceso diferentes para el token de desarrollador en orden. Si aún no tienes acceso a la API de Google Ads, puedes comenzar por registrarte para obtener un token de desarrollador con el nivel de acceso a la cuenta de prueba. Para aumentar el nivel de acceso, completa algunos pasos adicionales en la solicitud.
| Nivel de acceso | Puede acceder a... | Límite de operaciones diarias1 | Cómo postularse | ¿Cuánto suelen tardar las revisiones? |
|---|---|---|---|---|
| Nivel de acceso a la cuenta de prueba | Cuentas de prueba | 15,000 operaciones por día | Instrucciones | |
| Nivel de acceso al Explorador | Cuentas de prueba y de producción | 2,880 operaciones por día para las cuentas de producción 15,000 operaciones por día para las cuentas de prueba |
Instrucciones | |
| Nivel de acceso básico | Cuentas de prueba y de producción | 15,000 operaciones por día para las cuentas de prueba y de producción | Instrucciones | 5 días hábiles |
| Nivel de acceso estándar | Cuentas de prueba y de producción | Operaciones ilimitadas por día para las cuentas de prueba y de producción | Instrucciones | 10 días hábiles |
1 "Por día" se basa en un período de 24 horas en el que se realizaron solicitudes a la API con tu token de desarrollador. Tu aplicación recibirá un error si supera el límite de solicitudes para tu nivel de acceso en las últimas 24 horas.
Nivel de acceso a la cuenta de prueba
Después de completar el registro inicial en la API de Google Ads, se te emitirá un token de desarrollador con el nivel de acceso a la cuenta de prueba. Esto significa que el token de desarrollador solo puede realizar solicitudes a la API de Google Ads en cuentas de prueba.
.Cómo solicitar el nivel de acceso a la cuenta de prueba
Completa el registro en la API de Google Ads en la interfaz web de Google Ads para obtener automáticamente el nivel de acceso a la cuenta de prueba.
Nivel de acceso al Explorador
Después de completar el registro inicial en la API de Google Ads, Google puede actualizar automáticamente tu token de desarrollador del nivel de acceso a la cuenta de prueba al nivel de acceso al Explorador en algunos casos. El nivel de acceso al Explorador permite que el token de desarrollador realice solicitudes a la API de Google Ads en cuentas de prueba y de producción. Las cuentas de producción son aquellas que publican anuncios reales y activos de Google. Las cuentas de prueba no publican anuncios.
El nivel de acceso al Explorador permite que el token de desarrollador ejecute hasta 2,880 operaciones por día en cuentas de producción. Esto es suficiente para que la mayoría de los desarrolladores comiencen a usar la API y creen automatizaciones básicas.
El nivel de acceso al Explorador restringe el acceso a las siguientes funciones. Si necesitas usar estas funciones, debes solicitar el nivel de acceso básico o el nivel de acceso estándar.
| Funcionalidad restringida | Servicios y métodos restringidos |
|---|---|
| Creación de la cuenta | CustomerService.CreateCustomerClient |
| Administración de usuarios | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| Planificación |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| Facturación y pago de la cuenta |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Cómo solicitar el nivel de acceso al Explorador
Completa el registro en la API de Google Ads en la interfaz web de Google Ads. En algunos casos, Google puede actualizar automáticamente tu token de desarrollador al nivel de acceso al Explorador una vez que completes el registro.
Nivel de acceso básico
El nivel de acceso básico permite que el token de desarrollador realice solicitudes a la API de Google Ads en cuentas de prueba y de producción. Las cuentas de producción son aquellas que publican anuncios reales y activos de Google. Las cuentas de prueba no publican anuncios.
El nivel de acceso básico permite que el token de desarrollador ejecute hasta 15,000 operaciones por día. Esto es suficiente para la mayoría de los desarrolladores.
Cómo solicitar el nivel de acceso básico
Si tienes un token de desarrollador con el nivel de acceso a la cuenta de prueba o el nivel de acceso al Explorador, puedes solicitar el nivel de acceso básico de la siguiente manera:
Navega a https://ads.google.com/aw/apicenter en tu navegador web. Accede a tu cuenta de administrador de Google Ads si se te solicita.
Verifica que tu Nivel de acceso sea Cuenta de prueba o Explorador.
Asegúrate de que el Correo electrónico de contacto de la API en el centro de APIs esté actualizado. No podrás completar el proceso de solicitud sin una dirección de correo electrónico válida que revises con frecuencia. Asegúrate de haber vinculado todas tus cuentas activas de Google Ads a la cuenta de administrador de Google Ads con el token de la API.
Haz clic en la flecha desplegable junto al Nivel de acceso y, luego, en el vínculo Solicitar acceso básico.
Completa la verificación de marca de los proyectos de Google Cloud
La API de Google Ads usa el estado de verificación de marca de los proyectos de Google Cloud asociados con un token de desarrollador mientras revisa las solicitudes para el nivel de acceso básico. Puedes completar el proceso de verificación de marca en tu proyecto de Google Cloud para acelerar el proceso de revisión de tu solicitud de acceso básico. En algunos casos, es posible que Google también te solicite completar la verificación de marca en tus proyectos de Google Cloud como requisito previo para procesar tu solicitud de acceso básico. Consulta la guía de verificación de marca para obtener más información.
Nivel de acceso estándar
El nivel de acceso estándar permite que el token de desarrollador ejecute una cantidad ilimitada de operaciones por día para la mayoría de los servicios. Esto incluye, y , entre otras operaciones
GoogleAdsService Search y
SearchStream. Para obtener más detalles
sobre los límites y las excepciones al nivel de acceso estándar, consulta Cuotas de API.
El nivel de acceso estándar solo se otorga a los desarrolladores que requieren operaciones ilimitadas de la API de Google Ads, como las grandes empresas o las herramientas que atienden a muchos usuarios.
Cómo solicitar el nivel de acceso estándar
Si tienes un token de desarrollador con el nivel de acceso básico, puedes solicitar el nivel de acceso estándar de la siguiente manera:
Navega a https://ads.google.com/aw/apicenter en tu navegador web. Accede a tu cuenta de administrador de Google Ads si se te solicita.
Verifica que tu Nivel de acceso sea Básico.
Asegúrate de que el Correo electrónico de contacto de la API en el centro de APIs esté actualizado. No podrás completar el proceso de solicitud sin una dirección de correo electrónico válida que revises con frecuencia. Asegúrate de haber vinculado todas tus cuentas activas de Google Ads a la cuenta de administrador de Google Ads con el token de la API.
Haz clic en la flecha desplegable junto al Nivel de acceso y, luego, en el vínculo Solicitar acceso estándar.
Si usuarios externos usan tu herramienta, prepárate para proporcionar acceso de demostración a ella. Ten en cuenta que tu herramienta debe cumplir con la funcionalidad mínima requerida.
Cuotas de la API y límites de frecuencia del sistema
Independientemente del nivel de acceso, todas las operaciones de la API están sujetas a límites de frecuencia del sistema, que restringen la cantidad de operaciones que puedes realizar en un período determinado, es decir, la cantidad de operaciones por hora. Para obtener más información sobre cómo abordar los errores de límite de frecuencia, consulta Tipos de errores.
Los servicios individuales pueden aplicar límites y restricciones de cuota adicionales debido a motivos como limitaciones de diseño del producto, restricciones de la política del producto y consideraciones de rendimiento y latencia de la API. Consulta la documentación sobre las cuotas de la API para obtener más información sobre estas restricciones.
Uso permitido
El uso permitido solo se aplica a los tokens de desarrollador con los niveles de acceso básico y estándar. El uso permitido se asigna en función del uso previsto de la API de Google Ads. Estos permisos determinan para qué funciones de la API se puede usar un token de desarrollador, como se explica en la siguiente tabla:
| Uso permitido | Descripción |
|---|---|
| Creación y administración de anuncios | Proporciona acceso a todos los servicios de la API para crear y administrar campañas, grupos de anuncios, anuncios y palabras clave de Google Ads. |
| Informes | Solo realiza solicitudes GoogleAdsService.Search
o GoogleAdsService.SearchStream
o llamadas de solo lectura. Lo utilizan los desarrolladores que solo usan la API para solicitar estadísticas.
|
| Investigación de palabras clave y recomendaciones | Permite que el token de desarrollador acceda a RecommendationService,
KeywordPlanIdeaService,
y KeywordPlanService.
Solo lo usan las herramientas que requieren sugerencias para facilitar la
creación y administración de campañas de Google Ads.
|
Cómo cambiar el uso permitido
Si se aprobó tu token de desarrollador para el nivel de acceso básico o estándar, puedes completar la solicitud para actualizar el uso permitido use. Completa la solicitud si quieres actualizar tu uso permitido o para otorgarles a tus clientes acceso a tu herramienta.