Niveles de acceso y uso permitido

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 a diario. 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 los tokens 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 operación diario1	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 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 producción	15,000 operaciones por día para las cuentas de prueba y de producción	Instrucciones	Dos días hábiles
Nivel de acceso estándar	Cuentas de prueba y producción	Operaciones ilimitadas por día para las cuentas de prueba y de producción	Instrucciones	10 días hábiles

¹ "Por día" se basa en un período de 24 horas continuas 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 que se te otorgue automáticamente el nivel de acceso a la cuenta de prueba.

Nivel de acceso al Explorador

Después de que completes el registro inicial en la API de Google Ads, es posible que Google actualice automáticamente tu token de desarrollador del nivel de acceso a la cuenta de prueba al nivel de acceso de explorador en algunos casos. El nivel de acceso de Explorer 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 de 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 de Explorer 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	CustomerUserAccessInvitationService CustomerUserAccessService
Planificación	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService KeywordPlanIdeaService ReachPlanService
Facturación y pago de la cuenta	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

Cómo solicitar el nivel de acceso de Explorer

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 de Explorer 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 todas las cuentas 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 nivel de acceso a la cuenta de prueba y deseas solicitar acceso a la cuenta de producción, completa el formulario de solicitud de nivel de acceso básico. Asegúrate de haber completado estos pasos:

1. Asegúrate de tener un token de desarrollador con el nivel de acceso a la cuenta de prueba.
2. Asegúrate de que el correo electrónico de contacto de la API en el centro de APIs esté actualizado. Debes acceder a tu cuenta de administrador de Google Ads para ver el centro de APIs. 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.

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, GoogleAdsService Search y SearchStream, entre otras operaciones. 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 prestan servicio a muchos usuarios.

Cómo solicitar el nivel de acceso estándar

Si tienes un token de desarrollador con nivel de acceso básico y deseas solicitar operaciones ilimitadas de la API de Google Ads, completa el formulario de solicitud de nivel de acceso estándar.

Si tu herramienta es externa, 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, 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 niveles de acceso básico y estándar. El uso permitido se asigna según el 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.
Investiga 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. Completa la solicitud si quieres actualizar tu uso permitido o para otorgarles a tus clientes acceso a tu herramienta.