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 Reporting do Google Analytics, o que pode afetar os resultados dos dados.

O sistema de cota com base em recursos é novo e permite que as contas do Google Analytics 360 tenham limites de amostragem mais altos ao usar a API Reporting do Google Analytics. Esse sistema é opcional e independente dos limites existentes para visualizações e projetos, como os 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 baseada 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 de API precisa incluir o campo opcional useResourceQuotas no método batchGet.

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

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

Para 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 dos recursos de todos os ReportRequests na solicitação batchGet. 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. Consulte os 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. Não é um custo monetário, e a API é sem custo financeiro.
  • Os relatórios intradiários e alguns dados históricos (com mais de um ano) ainda podem estar sujeitos à amostragem, seja qual for a 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).
  • Um relatório contém dados de amostra se os campos samplesReadCounts e samplingSpaceSizes estiverem presentes na resposta.

Para conferir ou mudar os limites de uso do projeto ou solicitar um aumento da cota, siga estas etapas:

  1. Se você ainda não tem uma conta de faturamento para o 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 ver e mudar configurações relacionadas a cotas, selecione Cotas. Para ver as estatísticas de uso, selecione Uso.