Cota com base em recursos

Este documento descreve o sistema de cota com base em recursos para a API Reporting v4 do Google Analytics, que está disponível apenas para clientes do Google Analytics 360. Veja os limites e as cotas de API para o conjunto completo de limites aplicados às APIs.

Introdução

Para garantir a disponibilidade e a confiabilidade dos recursos compartilhados, todos os projetos que acessam a API de relatórios do Google Analytics estão sujeitos a limites e cotas. Ao consultar grandes conjuntos de dados, a amostragem pode ser empregada pela API de relatórios do Google Analytics, o que pode afetar os resultados dos dados.

O sistema de cota com base em recursos é novo e permitirá que as contas do Google Analytics 360 tenham limites de amostragem mais altos ao usar a API Reporting do Google Analytics. Este sistema é opcional e independente dos limites existentes para visualizações e projetos, como aqueles informados na página de cotas do Console de APIs do Google.

Cota com base em recursos

Nem todas as solicitações são criadas da mesma forma. Algumas são computacionalmente muito mais caras do que outras. O sistema de cota com base em recursos foi projetado para suportar um limite maior de amostragem e proteger a infraestrutura de relatórios do Google Analytics.

Cada propriedade receberá uma quantidade definida de tokens de recurso de consulta. O cliente da API poderá adicionar um campo opcional à solicitação da API para receber um limite mais alto de amostragem em troca desses tokens. Uma solicitação computacionalmente mais cara exigirá mais tokens.

Limite de amostragem

As solicitações de dados que usam a API Google Analytics v4 estão sujeitas aos seguintes limites gerais de amostragem, com base no número de sessões do período solicitado (no nível da propriedade):

  • Google Analytics Standard: 500 mil sessões
  • Google Analytics 360: 1 milhão de sessões
  • Google Analytics 360 usando cota com base em recursos: 100 milhões de sessões

Ativar a cota com base em recursos

Para ativar as cotas com base em recursos de uma determinada solicitação, a chamada da API precisa incluir o campo opcional useResourceQuotas no método batchGet.

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

Por exemplo:

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

Campo de resposta de custo do recurso de consulta

Em cada chamada para o método batchGet, a resposta terá um campo queryCost.

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

O campo queryCost é um número inteiro que representa o custo total do recurso de todas as ReportRequests na solicitação batchGet. Por exemplo:

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

Alocação de cotas

Cota de propriedades do Analytics 360

  • 100 mil unidades de custo de consulta por dia e por propriedade
  • 25 mil unidades de custo de consulta por hora por propriedade

Se você exceder o limite de cotas, o erro RESOURCE_EXHAUSTED será exibido. Veja mais detalhes em Respostas de erro.

Cálculo de custos

O custo de uma solicitação é proporcional ao seguinte:

  • Tamanho do período
  • Número de hits na visualização
  • Cardinalidade das dimensões solicitadas
  • Número de dimensões e métricas solicitadas
  • Complexidade das definições de segmento e filtro
  • Status de processamento das informações solicitadas (solicitar dados de hoje é mais caro do que solicitar os dados de ontem)
  • Presença das dimensões e métricas de importação de tempo de consulta

Limites e uso de APIs

Além do sistema de cota com base em recursos, as APIs também são regidas por limites e cotas na API Google Analytics v4.

Observações

  • O campo de resposta queryCost representa o custo computacional de uma solicitação. Ele não é um custo monetário, e o uso da API é gratuito.
  • Os dados intradiários e alguns dados históricos (com mais de um ano) ainda podem estar sujeitos a amostragem, independentemente da configuração de useResourceQuotas.
  • Se um limite de amostragem mais alto não for suficiente para uma solicitação, os tokens da cota de recursos não serão deduzidos (as respostas de amostra não têm custo de cota de recursos).
  • Se os campos samplesReadCounts e samplingSpaceSizes estiverem presentes na resposta, significa que o relatório contém dados de amostra.

Para visualizar ou alterar limites de uso do projeto ou para solicitar um aumento da cota, faça o seguinte:

  1. Se você ainda não tem uma conta de faturamento para seu projeto, crie uma.
  2. Acesse a página "APIs ativadas" da biblioteca de APIs no console de APIs e selecione uma API da lista.
  3. Para visualizar e alterar configurações relacionadas a cotas, selecione Cotas. Para ver as estatísticas de utilização, selecione Uso.