Las cuotas protegen la infraestructura de Google de los procesos automatizados que usan la API de Campaign Manager 360 de forma inapropiada. Garantizan que las acciones de un desarrollador no afecten negativamente a la comunidad en general.
Límites de cuota
Todos los recursos y métodos de la API de Campaign Manager 360 comparten los siguientes límites de cuota predeterminados.
- 50,000 solicitudes por proyecto y por día (se pueden aumentar)
- 1 consulta por segundo (QPS) por proyecto
- En la Consola de APIs de Google, esta cuota se denomina Queries per minute per user y está establecida en 60 de forma predeterminada. Este límite se puede aumentar según sea necesario, hasta un máximo de 600 (10 QPS).
El Creador de informes aplica límites de cuota adicionales que varían según la cuenta. Para obtener más información, consulta este artículo del Centro de ayuda y la siguiente tabla.
Superar los límites de cuota
En el improbable caso de que tu solicitud falle debido a que se excedió un límite de cuota, la API devolverá un código de estado HTTP y el motivo del error. Además, el cuerpo de la respuesta contiene una descripción detallada de la causa del error. Consulta la guía de Mensajes de error para ver un ejemplo de respuesta de error.
En la siguiente lista, se muestran los posibles errores y las acciones recomendadas para las fallas en las solicitudes causadas por exceder los límites de cuota.
| Código | Motivo | Mensaje | Acción recomendada |
|---|---|---|---|
| 403 | dailyLimitExceeded | Se superó el límite diario | No vuelvas a intentar la operación sin solucionar el problema. Examina tu uso en la Consola de APIs de Google y modifica tu flujo de trabajo para realizar menos solicitudes. Puedes solicitar una cuota adicional si crees que tu uso es razonable. |
| 403 | quotaExceeded | Esta cuenta superó su cuota de X informes por día. | No intentes ejecutar más informes para esta cuenta hoy. Comunícate con tu administrador de cuentas para obtener asistencia. |
| 403 | quotaExceeded | Este perfil de usuario superó su cuota de X informes por día. | No intentes ejecutar más informes para este perfil de usuario durante el día. Cambia a un perfil de usuario diferente o comunícate con tu administrador de cuentas para obtener ayuda. |
| 403 | quotaExceeded | Esta cuenta superó su cuota de X informes programados activos. | Desactiva los informes programados que no necesites antes de reintentar esta solicitud. |
| 403 | quotaExceeded | El perfil de usuario propietario de este informe superó su cuota de X informes programados activos. | Pídele al propietario de este informe que desactive los informes programados que no necesite antes de volver a intentar esta solicitud. |
| 403 | quotaExceeded | Este perfil de usuario superó su cuota de X informes programados activos. | Desactiva los informes programados que no necesites antes de reintentar esta solicitud. |
| 403 | quotaExceeded | No se puede completar esta acción porque se excedió una de sus cuotas. Comuníquese con su administrador de cuentas para obtener ayuda. | Comunícate con tu administrador de cuentas para obtener asistencia. |
| 403 | userRateLimitExceeded | Se superó el límite de frecuencia del usuario | Aumenta el límite por usuario en la consola de APIs de Google o reduce la velocidad a la que envías solicitudes con la reexpansión exponencial. No se recomienda realizar solicitudes de escritura simultáneas ni emplear un límite de frecuencia superior a 10 QPS con esta API. |
Solicita cuota diaria adicional
Si crees que tu aplicación requiere una cuota diaria adicional, puedes solicitar más siguiendo las instrucciones que se indican a continuación.
Las siguientes instrucciones solo se aplican a los proyectos que tuvieron un error de dailyLimitExceeded. Las acciones recomendadas para otros errores de cuota se incluyen en la tabla anterior.
- Navega a la API de Campaign Manager 360 en la consola de APIs de Google.
- Revisa tus estadísticas de uso en la página Métricas para asegurarte de que tu aplicación se comporte como se espera. Presta mucha atención a los métodos que se llamaron y aborda cualquier uso inesperado o excesivo antes de continuar.
- Si el uso parece normal, navega a la página Cuotas, haz clic en el ícono de edición junto a Consultas por día y, luego, en el vínculo para "Solicitar una cuota más alta".
Asegúrate de revisar la información y seguir las instrucciones incluidas en el formulario de solicitud de cuota antes de enviar una solicitud de aumento.