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 tres niveles de acceso diferentes en orden. Si aún no tienes acceso a la API de Google Ads, puedes comenzar por registrarte para obtener acceso a una cuenta de prueba. Para aumentar el nivel de acceso, completa algunos pasos adicionales en la aplicación.

Nivel de acceso Puede acceder a… Límite de operación diario1 Aplicar
Prueba el acceso a la cuenta Cuentas de prueba 15,000 operaciones por día Instrucciones
Acceso básico Cuentas de prueba y producción 15,000 operaciones por día Instrucciones
Acceso estándar Cuentas de prueba y producción Operaciones ilimitadas por día Instrucciones

1 "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.

Prueba el acceso a la cuenta

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 acceso a una 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.

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 acceso básico

Si tienes un token de desarrollador con el nivel de acceso a la cuenta de prueba y deseas solicitar acceso a la cuenta de producción, completa el formulario de solicitud 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 API esté actualizado. Debes acceder a tu cuenta de administrador para ver el Centro de API. 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 con el token de la API.

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, entre otros, 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 la 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 servicios a muchos usuarios.

Independientemente del nivel de acceso, todas las operaciones de la API están sujetas a límites de frecuencia del sistema. Para obtener más información sobre cómo controlar los errores de límite de frecuencia, consulta Tipos de errores.

Cómo solicitar 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 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 Obligatoria.

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 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. Esto es para los desarrolladores que solo usan la API para solicitar estadísticas.
Investiga palabras clave y recomendaciones Permite que el token acceda a RecommendationService, KeywordPlanIdeaService y KeywordPlanService. Solo la 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 otorgarles a tus clientes acceso a tu herramienta.