Quota basata sulle risorse

Questo documento descrive il sistema di quote basate sulle risorse per l'API di reporting di Google Analytics v4, disponibile solo per i clienti di Analytics 360. Consulta Limiti e quote delle API per conoscere l'insieme completo dei limiti applicati alle API.

Introduzione

Per garantire la disponibilità e l'affidabilità delle risorse condivise, ogni progetto che accede all'API Analytics Reporting è soggetto a limiti e quote. Quando esegui query su set di dati di grandi dimensioni, l'API di reporting di Analytics potrebbe utilizzare il campionamento, il che può influire sui risultati dei dati.

Il sistema di quote basato sulle risorse è un nuovo sistema di quote che consentirà agli account Analytics 360 di avere soglie di campionamento più elevate durante l'utilizzo dell'API di reporting di Analytics. Questo sistema è facoltativo e indipendente dai limiti esistenti applicati alle viste e ai progetti, ad esempio quelli riportati nella pagina Quote della console API di Google.

Quota basata sulle risorse

Non tutte le richieste vengono create allo stesso modo; alcune sono computazionali molto più costose di altre. Il sistema di quote basato sulle risorse è progettato per supportare una soglia di campionamento più elevata proteggendo al contempo l'infrastruttura dei report di Analytics.

A ogni proprietà verrà allocato un numero prestabilito di token di risorse di query. Il client API può aggiungere un campo facoltativo alla richiesta API per ottenere una soglia di campionamento più elevata in cambio dei relativi token delle risorse di query. Una richiesta di costo di calcolo più costosa richiederà più token.

Soglia di campionamento

Le richieste di dati che utilizzano l'API Google Analytics v4 sono soggette alle seguenti soglie generali di campionamento, basate sul numero di sessioni per l'intervallo di date richiesto (a livello di proprietà):

  • Analytics Standard: 500.000 sessioni
  • Analytics 360: 1 milione di sessioni
  • Analytics 360 utilizza la quota basata sulle risorse: 100 milioni di sessioni

Abilita quota basata sulle risorse

Per abilitare le quote basate sulle risorse per una determinata richiesta, la chiamata API deve includere il campo facoltativo useResourceQuotas nel metodo batchGet.

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

Ad esempio:

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

Campo della risposta del costo delle risorse di query

Per ogni chiamata al metodo batchGet, la risposta avrà un campo queryCost.

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

Il campo queryCost è un numero intero che rappresenta il costo totale delle risorse di tutti i ReportRequests nella richiesta batchGet. Ad esempio:

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

Assegnazione delle quote

Quota delle proprietà Analytics 360

  • 100.000 unità di costo di query al giorno per proprietà.
  • 25.000 unità di costo di query all'ora per proprietà.

Se superi il limite della quota, riceverai un errore RESOURCE_EXHAUSTED. Per informazioni dettagliate, vedi Risposte di errore.

Calcolo dei costi

Il costo di una richiesta è proporzionale a:

  • La dimensione dell'intervallo di date.
  • Il numero di hit all'interno della vista.
  • La cardinalità delle dimensioni richieste.
  • Il numero di dimensioni e metriche richieste.
  • La complessità delle definizioni di segmenti e filtri.
  • Lo stato di elaborazione delle informazioni richieste (la richiesta dei dati di oggi è più costosa di quella di ieri).
  • La presenza di dimensioni e metriche di importazione tempo query.

Limiti e utilizzo delle API

Oltre al sistema di quote basato sulle risorse, le API sono regolate anche da limiti e quote nell'API Analytics v4.

Note

  • Il campo della risposta queryCost rappresenta il costo di calcolo di una richiesta. Non si tratta di un costo monetario e l'utilizzo dell'API è senza costi.
  • I report infragiornalieri e alcuni report con dati storici (da 1 o più anni) possono ancora essere soggetti a campionamento, indipendentemente dall'impostazione useResourceQuotas.
  • Se non è possibile soddisfare una soglia di campionamento più alta per una richiesta, i token della quota delle risorse non verranno detratti (le risposte campionate hanno sempre un costo della quota delle risorse pari a zero).
  • Un report contiene dati campionati se nella risposta sono presenti i campi samplesReadCounts e samplingSpaceSizes.

Per visualizzare o modificare i limiti di utilizzo relativi al progetto o per richiedere un incremento della quota, procedi come segue:

  1. Se non hai ancora un account di fatturazione per il progetto, creane uno.
  2. Visita la pagina API abilitate della libreria di API nella console API e seleziona un'API dall'elenco.
  3. Per visualizzare e modificare le impostazioni relative alla quota, seleziona Quote. Per visualizzare le statistiche sull'utilizzo, seleziona Utilizzo.