Limitar el uso de la API

Según la API, puedes limitar de forma explícita las solicitudes si limitas las solicitudes por día, las solicitudes por minuto o las solicitudes por minuto por usuario.

Estos son límites de uso específicos de la API. Por ejemplo, para evitar cargos por exceder el uso gratuito, puedes establecer límites de solicitudes por día.

Estos límites están diseñados para controlar de forma detallada los volúmenes de servicios específicos y no para actuar como un límite de inversión para todo el proyecto. Si deseas evitar costos inesperados para todo tu proyecto o cuenta de facturación, consulta Crea, edita o borra presupuestos y alertas de presupuesto.

Importante: Los límites de cuota no siempre son completamente precisos, ya que existe cierta latencia entre el momento en que se supera una cuota y el momento en que comienza la aplicación. Cuando utilices la cuota como herramienta para limitar la facturación, permite un margen.

Cómo ver y modificar los límites de la cantidad de solicitudes

Puedes establecer límites en todas las solicitudes a cualquier API facturable. La mayoría de las API establecen límites predeterminados, pero puedes cambiar ese límite hasta el máximo especificado por Google. Algunas API establecen un límite bajo hasta que habilitas la facturación en tu proyecto.

Para ver o modificar los límites de tu API, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Panel de APIs y servicios.

   Ir al panel de APIs y servicios

2. En la lista de proyectos, selecciona un proyecto o crea uno nuevo.
3. Haz clic en el nombre de la API que te interesa.
4. Haz clic en Cuotas. Si la pestaña Cuotas no aparece en la navegación por pestañas, significa que la API que seleccionaste no tiene cuotas definidas.
5. Para encontrar la cuota que quieres limitar, ingresa las propiedades y los valores adecuados en el campo Filtro . Por ejemplo, para buscar la cuota de Subredes, ingresa Quota:Subnetworks.
6. Haz clic en la casilla de verificación junto a la cuota que quieres limitar y, luego, haz clic en EDITAR CUOTAS.
7. Completa el formulario de cambio de cuota, incluido el límite nuevo que deseas establecer.
8. Haz clic en ENVIAR SOLICITUD.

Algunas APIs te permiten solicitar un límite mayor enviando un formulario. Algunas APIs te permiten especificar una cuota más alta solo si la facturación está habilitada en el proyecto.

Nota: Puedes establecer límites de facturación por día solo en las API facturables y, en algunos casos, solo si está habilitada la facturación en tu proyecto. Si tu proyecto no usa ninguna API facturable, no puedes establecer límites diarios. Obtén más información sobre las cuentas de facturación.

Las secciones de cuotas del plan Premium se relacionan con el plan Premium de Google Maps, que ya no se ofrece. A menos que seas un cliente actual del plan Premium de Google Maps, no edites esas secciones.

Limita las solicitudes por usuario

Para evitar que los usuarios individuales usen por demás tu cuota de API, algunas APIs incluyen un límite predeterminado por usuario y por minuto.

Para verificar si tu API incluye un límite predeterminado por usuario y por minuto, búscalo en las cuotas de la API, como se describe en las instrucciones para Ver y modificar los límites en la cantidad de solicitudes. Si existe un límite predeterminado para esa API, puedes modificar ese valor para limitar la cuota disponible para cada usuario siguiendo los pasos que se indican en estas instrucciones. Si tu API no incluye este límite predeterminado en sus cuotas, no se admite su modificación o adición.

De forma predeterminada, el sistema usa la principal autenticada para identificar de forma única a los usuarios individuales. La principal autenticada incluye cuentas de usuario que usan tokens de OAuth, cuentas de servicio o identidades federadas de cargas de trabajo. Si no hay una principal autenticada, el sistema usa la dirección IP de cliente. Dado que este comportamiento de resguardo está activo de forma predeterminada, las cuotas por usuario se aplican incluso si no especificas un identificador de usuario.

El uso de la dirección IP del cliente como alternativa tiene dos limitaciones clave:

• IPs públicas compartidas: Varios usuarios detrás de una puerta de enlace o proxy de traducción de direcciones de red (NAT), como una oficina escolar o un extremo de VPN, compartirán una sola dirección IP pública. Sus solicitudes se agruparán en el mismo bucket de cuota, lo que podría provocar un agotamiento prematuro de la cuota.
• Evasión basada en la IP: Los usuarios con acceso a grandes bloques de direcciones IPv6 o proxies de VPN pueden rotar las direcciones IP del cliente para eludir la límite de frecuencia, lo que hace que la IP de resguardo no sea confiable para una protección sólida contra el abuso.

Si llamas a la API desde una aplicación del servidor, en la que el código de llamada se aloja en un servidor de tu propiedad, en nombre de varios usuarios y usas una sola entidad autenticada, todas las llamadas se atribuirán a esa única entidad. En este caso, no se pueden limitar las llamadas de usuarios individuales por separado. Para evitar esto, puedes anular la identificación de usuario predeterminada y el uso de la cuota de partición especificando el parámetro quotaUser o el encabezado X-Goog-Quota-User en tus solicitudes. Estos se definen en la documentación de Parámetros del sistema.

Para anular la identificación predeterminada del usuario con el parámetro quotaUser o el encabezado X-Goog-Quota-User, debes identificar el proyecto de cuota con una clave de API válida con restricciones de servicio, como restricciones de dirección IP o restricciones de URL de referencia HTTP. De lo contrario, se ignorará el parámetro o el encabezado, y el sistema volverá a la identificación predeterminada del usuario.

Para identificar a un usuario, usa el parámetro de consulta de URL quotaUser=userID. Este valor es solo para la aplicación de cuotas a corto plazo, por lo que no necesitas usar el ID de usuario real. Puedes elegir cualquier string arbitraria de menos de 40 caracteres que identifique de forma única a un usuario.

Nota: Aunque los límites por usuario se especifican en consultas por segundo, permitimos picos de uso a corto plazo. Por lo tanto, debes establecer tus límites en función de los niveles de tráfico sostenido. Si alguien intenta usar una API de forma que exceda esta configuración, las solicitudes activaran un error de límite excedido.

Para proteger la privacidad del usuario y limitar el volumen de métricas, la consola de Google Cloud y Cloud Monitoring no almacenan ni muestran la telemetría analizada por unaquotaUsero dirección IP individual. Puedes ver el límite de cuota general del proyecto y el uso total, pero no puedes supervisar, anular ni configurar alertas para usuarios individuales específicos.

Si tu API no incluye un límite predeterminado por usuario y por minuto, se ignorarán los valores de quotaUser.

Importante: Cuando envías cualquier identificador de usuario, asegúrate de satisfacer las leyes locales, incluso las leyes relacionadas con la divulgación de toda información personal que envías en cada solicitud. Recomendamos incluir la menor cantidad de información personal posible.

Visualiza y edita todas las cuotas para las API en un proyecto

Puedes revisar, editar y solicitar un límite de cuota mayor para todas las APIs facturables en un proyecto específico si revisas la página de Cuotas en la sección IAM y administración de la consola deGoogle Cloud .

Si deseas revisar y editar las cuotas para todas las API facturables en tu proyecto, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Cuotas.

   Ir a Cuotas

2. En la lista de proyectos, selecciona un proyecto o crea uno nuevo. Se mostrará la página Cuotas del proyecto seleccionado con una lista de elementos de una sola línea para cada tipo de cuota disponible en cada servicio.
3. Haz clic en Filtrar tabla para consultar tu cuota por una propiedad específica.
4. Marca la casilla junto a las cuotas que deseas editar. Solo se pueden usar algunas casillas de verificación cuando el proyecto tiene activada la facturación.
   Si prefieres editar todas las cuotas de una sola API, haz clic en el nombre del servicio para acceder a la página Cuotas de esa API.
5. Haz clic en Editar cuotas.
6. En el panel Cambios en la cuota que se muestra, expande la vista del servicio, edita las cuotas de ese servicio según sea necesario y, luego, haz clic en LISTO.
7. Repite los pasos para editar las cuotas en cada uno de los servicios seleccionados.
   • Los límites de cuota actuales se completan previamente en los cuadros de entrada.
   • Un servicio con un ícono de alerta () en el envío tiene errores de entrada.
   • Puedes agregar más cuotas para editar si las seleccionas como se describió anteriormente.
   • Para quitar un servicio del panel Cambios en la cuota, coloca el cursor sobre la vista de servicio no expandida y haz clic en el ícono de borrar ().
8. Cuando termines de editar las cuotas, haz clic en SIGUIENTE.
9. Si tu solicitud de edición de cuota necesita revisión, se mostrará el formulario Detalles de contacto. Completa el formulario con tus detalles de contacto.
10. Haz clic en ENVIAR SOLICITUD.