Las pruebas son un paso importante para crear una integración exitosa de la API de Google Ads, ya sea que recién comiences, mantengas una app o 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 de 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, incluidos la facturación (BillingSetupService
y AccountBudgetProposalService),
la planificación, la creación de cuentas y las invitaciones de usuarios (consulta las restricciones de 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 muestra
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:
- Publican anuncios que los usuarios pueden ver.
- Requieren URLs válidas.
- Deben cumplir con las políticas publicitarias
Debido a que las cuentas de producción publican anuncios, generan métricas que te permiten probar los informes de rendimiento, además de desbloquear todas las demás funciones de la API de Google Ads. Sin embargo, usarlas 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 diario fijo y bajo para la cuenta.
- 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 credenciales 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 estén separadas 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 fines de prueba. - Agrega este usuario o cuenta de servicio como 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 le otorgues acceso a este usuario o cuenta de servicio a ninguna cuenta de producción.
- Si usas el flujo de autenticación de usuarios de OAuth 2.0 en lugar del flujo de 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 volver a usar para fines de prueba, ya que no tienen ningún efecto para determinar a qué cuentas de Google Ads se puede acceder. Almacena todas las credenciales y los tokens de actualización de forma segura y nunca los confirmes en el control de origen.
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 validate_only campo, que está disponible para
GoogleAdsService.Search solicitudes (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 para realizar solicitudes a la API de REST. Además, intenta realizar pruebas en el Explorador de REST.