Tabelas dinâmicas

O endpoint /pivot/<Column Names> agrupa linhas por uma ou mais colunas e aplica uma agregação às demais. Combinado com _agg e _columns, permite criar resumos diretamente pela API.

Parâmetros

Parâmetro	Descrição
_agg	Tipo de agregação. Aceita as mesmas agregações.
_columns	Divide os grupos usando as colunas indicadas

_agg aceita: sum, prod, max, min, mean, median, std, var, any, all.

Agrupar por uma coluna

Agrupe as linhas por Name e agregue as colunas restantes com max.

cURL

curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/pivot/Name?_agg=max'

JavaScript

fetch(
  'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/pivot/Name?_agg=max'
);

Python

import requests

requests.get(
    'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/pivot/Name',
    params={'_agg': 'max'},
)

Agrupar por várias colunas

Passe uma lista de colunas separadas por vírgulas. A resposta é agrupada por cada combinação única.

cURL

curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/pivot/Name,Age?_agg=max'

JavaScript

fetch(
  'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/pivot/Name,Age?_agg=max'
);

Python

import requests

requests.get(
    'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/pivot/Name,Age',
    params={'_agg': 'max'},
)

Dividir grupos com _columns

Use _columns para dividir os grupos por colunas adicionais.

curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/pivot/Name?_agg=mean&_columns=Department'

Observações

• A lista de operações é a mesma de Agregações; valores que não podem ser agregados pela operação escolhida são ignorados.
• Para calcular uma única agregação da planilha inteira sem agrupar, use /agg/<operation>.