Maneja errores de API

Cuando envías una solicitud a la API de Google Ads, es posible que falle por varios motivos. Por ejemplo, es posible que proporciones un argumento no válido o que tu cuenta haya alcanzado el límite de creación de campañas nuevas. En estos casos, la API devuelve un error para informarte qué sucedió.

En esta guía, se explica cómo leer y controlar los errores de la API para que puedas compilar aplicaciones más sólidas.

Estructura del error

Si usas una de nuestras bibliotecas cliente, los errores de la API se muestran como excepciones. Estas excepciones contienen detalles que te ayudan a comprender por qué ocurrió el error.

La API de Google Ads devuelve información de errores en un formato estándar. Si se produce un error, la respuesta contendrá un objeto GoogleAdsFailure. Este objeto contiene una lista de objetos GoogleAdsError individuales, cada uno de los cuales detalla un error específico.

Cada objeto GoogleAdsError proporciona lo siguiente:

• error_code: Es un código de error específico que indica el tipo de error, como AuthenticationError.NOT_ADS_USER.
• message: Es una descripción legible de por qué se produjo el error.
• trigger: Es el valor que causó el error, como "1234".
• location: Detalles sobre qué parte de la solicitud causó el error, como el nombre de un campo específico.

Además de la lista de errores, GoogleAdsFailure contiene un requestId, que es un identificador único para la solicitud a la API que generó un error.

Ejemplo de error

Este es un ejemplo de cómo se ve un error en formato JSON. Este error indica que falta el campo name del objeto ad_group en el índice 0 de la solicitud.

{
  "code": 3,
  "message": "Request contains an invalid argument.",
  "details": [
    {
      "@type": "type.googleapis.com/google.ads.googleads.v22.errors.GoogleAdsFailure",
      "errors": [
        {
          "errorCode": {
            "requestError": "REQUIRED_FIELD_MISSING"
          },
          "message": "Required field is missing",
          "location": {
            "fieldPathElements": [
              {
                "fieldName": "ad_group",
                "index": 0
              },
              {
                "fieldName": "name"
              }
            ]
          }
        }
      ],
      "requestId": "unique_request_id_12345"
    }
  ]
}

Cómo controlar los errores

Si encuentras un error, sigue estos pasos:

1. Examina la lista errors: Observa cada GoogleAdsError en el objeto GoogleAdsFailure. Los campos error_code y message te indicarán qué salió mal.
2. Verifica location: El campo location puede ayudarte a identificar en qué parte de tu solicitud ocurrió el problema.
3. Consulta la documentación: Para obtener más detalles sobre los códigos de error específicos y cómo corregirlos, consulta la página de errores comunes o la referencia completa de códigos de error.
4. Ajusta tu solicitud: Según el mensaje de error, corrige tu solicitud a la API. Por ejemplo, si ves REQUIRED_FIELD_MISSING, asegúrate de proporcionar ese campo en tu solicitud.
5. Registra el request_id: Si no puedes resolver un error y necesitas comunicarte con el equipo de asistencia al cliente a través del foro, incluye el request_id. Este ID ayuda a los ingenieros de Google a investigar tu problema.

Próximos pasos

• Revisa la sección Errores comunes para ver una lista de los problemas frecuentes y sus soluciones.
• Para conocer técnicas más avanzadas de manejo de errores, incluida la lógica de reintento y la falla parcial, consulta Cómo comprender los errores de la API.