Cuota basada en recursos

En este documento, se describe el sistema de cuotas basado en recursos para la API de Google Analytics Reporting v4, que solo está disponible para los clientes de Analytics 360. Consulta Límites y cuotas de las APIs para ver el conjunto completo de límites que se aplican a las APIs.

Actualmente, la función de cuota basada en recursos está disponible para todos los clientes de Analytics 360.

Introducción

Para garantizar la disponibilidad y confiabilidad de los recursos compartidos, cada proyecto que accede a la API de Analytics Reporting está sujeto a límites y cuotas. Cuando se consultan conjuntos de datos grandes, se puede usar el muestreo con la API de Analytics Reporting, lo que puede afectar los resultados de tus datos.

El sistema de cuotas basado en recursos es un nuevo sistema de cuotas que permitirá que las cuentas de Analytics 360 tengan umbrales de muestreo más altos mientras usan la API de Analytics Reporting. Este sistema es opcional y no depende de los límites establecidos para las vistas y los proyectos, como los que se informan en la página de cuotas de la Consola de API de Google.

Cuota basada en recursos

No todas las solicitudes se crean de la misma manera; algunas solicitudes son mucho más costosas que otras en términos de procesamiento. El sistema de cuotas basado en recursos está diseñado para admitir un umbral de muestreo más alto y, al mismo tiempo, proteger la infraestructura de informes de Analytics.

A cada propiedad se le asignará una cantidad establecida de tokens de recursos de consulta. El cliente de la API puede agregar un campo opcional a la solicitud a la API para obtener un umbral de muestreo más alto a cambio de los tokens de recursos de consulta relativos. Una solicitud más costosa en términos de procesamiento requerirá más tokens.

Umbral de muestreo

Las solicitudes de datos que se realizan a través de la API de Google Analytics v4 están sujetas a los siguientes umbrales de muestreo generales basados en la cantidad de sesiones del período solicitado (a nivel de la propiedad):

• Analytics estándar: 500,000 sesiones
• Analytics 360: 1 millón de sesiones
• Analytics 360 usa la cuota basada en recursos: 100 millones de sesiones

Habilitar la cuota basada en recursos

Para habilitar las cuotas basadas en recursos de una solicitud determinada, la llamada a la API debe incluir el campo opcional useResourceQuotas en el método batchGet.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

Por ejemplo:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

Campo de respuesta de costo del recurso de consulta

Para cada llamada al método batchGet, la respuesta tendrá un campo queryCost.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

El campo queryCost es un número entero que representa el costo total de los recursos de todos los ReportRequests en la solicitud batchGet. Por ejemplo:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

Asignación de cuotas

Cuota de la propiedad de Analytics 360

• 100,000 unidades de costo de consultas al día por propiedad
• 25,000 unidades de costo de consultas por hora y por propiedad

Si superas el límite de la cuota, recibirás un error RESOURCE_EXHAUSTED. Consulta Respuestas de error para obtener más detalles.

Nota: Estos valores son preliminares y pueden cambiar durante el período beta o después de él.

Importante: Las cuotas diarias se actualizan a la medianoche (PST).

Cálculo de costos

El costo de una solicitud es proporcional a lo siguiente:

• Indica el tamaño del período.
• Es la cantidad de hits en la vista.
• Es la cardinalidad de las dimensiones solicitadas.
• Es la cantidad de dimensiones y métricas solicitadas.
• La complejidad de las definiciones de segmento y filtro
• El estado de procesamiento de la información solicitada (solicitar los datos de hoy es más costoso que solicitar los datos del día anterior).
• La presencia de las dimensiones y métricas de importación por tiempo de consulta

Nota: Si una solicitud experimenta un tiempo de espera agotado, y esto genera una respuesta 5XX, se cobrará el costo de la cuota de recursos de todas formas. Consulta la página Respuesta de error si quieres obtener detalles para implementar la retirada exponencial para evitar un uso excesivo de la cuota.

Límites y uso de la API

Además del sistema de cuotas basado en recursos, las APIs también se rigen por los límites y cuotas de la API de Analytics v4.

Notas

• El campo de respuesta queryCost representa el costo de procesamiento de una solicitud. No tiene un costo monetario y la API es de uso gratuito.
• Es posible que los informes de datos intradía y ciertos datos históricos (de 1 año o más) aún estén sujetos al muestreo, independientemente de la configuración de useResourceQuotas.
• Si no se puede cumplir con un umbral de muestreo más alto para una solicitud, no se deducirán los tokens de cuota de recursos (las respuestas de muestra siempre tienen un costo de cuota de recursos cero).
• Un informe contiene una muestra de datos si la respuesta incluye campos samplesReadCounts y samplingSpaceSizes.

Si deseas ver o cambiar los límites de uso de tu proyecto, o solicitar un aumento de la cuota, haz lo siguiente:

1. Si no tienes una cuenta de facturación para tu proyecto, crea una.
2. Visita la página de API habilitadas de la biblioteca de API en la Consola de APIs y selecciona una API de la lista.
3. Si deseas consultar y cambiar la configuración de cuotas, selecciona la opción Cuotas. Para consultar las estadísticas de uso, selecciona la opción Uso.