Las pruebas son un paso importante para crear una integración exitosa de la API de Google Ads, ya sea que recién estés comenzando, que mantengas una app o que agregues funciones nuevas a una integración existente. En esta guía, se presentan algunas prácticas recomendadas para probar tu integración de la API de Google Ads.
Cuentas de prueba y cuentas de producción
Las cuentas de prueba están disponibles para fines de desarrollo. Con las cuentas de prueba, puedes validar que el código y la configuración de tu aplicación funcionen según lo previsto.
Sin embargo, no todas las funciones se pueden probar en una cuenta de prueba.
Cuando las limitaciones de la cuenta de prueba te impidan probar algunas funciones en tu
integración, puedes usar una cuenta de producción para el desarrollo. Tu
proyecto de Google Cloud debe tener, al menos, el
nivel de acceso Explorador (Explorador, Básico o Estándar) para
llamar a una cuenta de producción. Ten en cuenta que el acceso de explorador aún restringe ciertos
servicios, como la facturación (BillingSetupService
y AccountBudgetProposalService),
la planificación, la creación de cuentas y las invitaciones de usuarios (consulta las restricciones de las funciones de
explorador), que requieren acceso básico o
estándar. Si intentas llamar a una cuenta de producción desde un proyecto con el nivel de acceso de prueba, se mostrará el error AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION a partir de v25 o AuthorizationError.ACTION_NOT_PERMITTED en v24 y versiones anteriores.
Las cuentas de producción para el desarrollo difieren de las cuentas de prueba de las siguientes maneras:
- Publica anuncios que los usuarios puedan ver
- Se deben proporcionar URLs válidas
- Debe satisfacer las políticas publicitarias.
Como las cuentas de producción publican anuncios, generan métricas que te permiten probar los informes de rendimiento y desbloquear todas las demás funciones de la API de Google Ads. Sin embargo, usarlos para el desarrollo requiere precaución adicional. Te recomendamos que tomes las siguientes medidas:
- Solo otorga acceso a los usuarios que lo necesiten para fines de desarrollo.
- Establece un presupuesto de la cuenta diario bajo y fijo.
- Usa cuentas de producción para el desarrollo solo cuando no se puedan usar cuentas de prueba.
Por lo tanto, para realizar pruebas completas de tu integración, es probable que necesites credenciales de prueba y de producción.
Credenciales de prueba
Para minimizar el riesgo de modificar accidentalmente las cuentas de producción cuando intentas modificar las cuentas de desarrollo, te recomendamos que mantengas un conjunto de credenciales de prueba que sean independientes de las credenciales de tu aplicación de producción.
Para crear un conjunto de credenciales de prueba, sigue estos pasos:
- Crea una cuenta de correo electrónico (por ejemplo,
api.test@example.com) o una cuenta de servicio que se usará solo para realizar pruebas. - Agrega este usuario o cuenta de servicio como un usuario válido en las cuentas de Google Ads en las que ejecutas tus pruebas. Asegúrate de otorgar los niveles de acceso adecuados a este usuario o cuenta de servicio. No otorgues a este usuario o cuenta de servicio acceso a ninguna cuenta de producción.
- Si usas el flujo de autenticación de usuarios de OAuth 2.0, en lugar del flujo de la cuenta de servicio, genera un token de actualización para tu cuenta de usuario de prueba.
- Usa estas credenciales nuevas cuando pruebes tu aplicación. El ID de cliente y el secreto de cliente se pueden reutilizar con fines de prueba, ya que no influyen en la determinación de las cuentas de Google Ads a las que se puede acceder. Almacena todas las credenciales y los tokens de actualización de forma segura, y nunca los confirmes en el control de código fuente.
Validación de la solicitud
Si solo necesitas probar si una solicitud es válida (por ejemplo, para verificar que la solicitud esté estructurada correctamente y no infrinja las políticas), puedes usar el campo validate_only, que está disponible para las solicitudes GoogleAdsService.Search (ten en cuenta que GoogleAdsService.SearchStream no admite validate_only) y la mayoría de las solicitudes de mutación. Consulta la
documentación de referencia para verificar si este campo está
disponible para un método determinado.
API de REST
Para las pruebas ad hoc, por ejemplo, para validar que una solicitud produzca el resultado esperado, usar la API de REST suele ser la opción más sencilla. Consulta los ejemplos de REST para aprender a usar curl en la realización de solicitudes a la API de REST. Además, prueba en el explorador de REST.