Quota basata sulle risorse

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

La funzionalità della quota basata sulle risorse è attualmente disponibile per tutti i clienti di Analytics 360.

Introduzione

Per garantire la disponibilità e l'affidabilità delle risorse condivise, ogni progetto che accede all'API Analytics Reporting è soggetto a limiti e quote. Durante l'esecuzione di query su set di dati di grandi dimensioni, l'API Analytics Reporting 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 consente agli account Analytics 360 di avere soglie di campionamento più elevate durante l'utilizzo dell'API Analytics Reporting. Questo sistema è facoltativo e indipendente dai limiti previsti per viste e progetti, come quelli riportati nella pagina delle quote della console API di Google.

Quota basata sulle risorse

Non tutte le richieste vengono create uguali; 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à assegnato 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 maggiore in cambio dei relativi token delle risorse della query. Una richiesta più costosa dal punto di vista del calcolo richiederà più token.

Soglia di campionamento

Le richieste di dati che utilizzano l'API Google Analytics v4 sono soggette alle seguenti soglie di campionamento generali 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 gli elementi ReportRequests nella richiesta batchGet. Ad esempio:

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

Assegnazione delle quote

Quota proprietà Analytics 360

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

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

Nota: questi valori sono preliminari e potrebbero cambiare durante e/o dopo il periodo beta.

Importante: le quote giornaliere vengono aggiornate a mezzanotte PST.

Calcolo dei costi

Il costo di una richiesta è proporzionale a:

• La dimensione dell'intervallo di date.
• Il numero di hit all'interno della visualizzazione.
• 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 di dati di oggi è più costosa di quella di ieri).
• La presenza di dimensioni e metriche di importazione tempo query.

Nota: in caso di timeout di una richiesta che genera una risposta 5XX, verrà comunque addebitato il costo della quota delle risorse. Consulta la pagina Risposta di errore per i dettagli sull'implementazione del backoff esponenziale per evitare un utilizzo eccessivo della quota.

Limiti e utilizzo delle API

Oltre al sistema di quote basato sulle risorse, le API sono regolate anche da limiti e quote della versione 4 dell'API Analytics.

Note

• Il campo di 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 di alcuni dati storici (che hanno più di 1 anno) potrebbero comunque essere soggetti a campionamento, indipendentemente dall'impostazione useResourceQuotas.
• Se non è stato possibile soddisfare una soglia di campionamento più alta per una richiesta, i token della quota di 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 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.