Saltar al contenido principal

Formatos de datos

De forma predeterminada, Sheet Best devuelve las filas como una lista de registros. Añade el parámetro opcional _format a cualquier GET para cambiar la estructura de la respuesta. Añade _raw=1 para devolver tipos nativos (números, booleanos) en lugar de cadenas de texto.

En las conexiones de carpetas de Google Drive, estos formatos cambian la estructura de los metadatos de archivos (id, name y link). Elegir _format=index no lee el contenido de las hojas de cálculo de la carpeta. Las claves de índice no son identificadores de archivo estables; usa el id de cada registro para identificar el archivo.

El parámetro _format​

FormatoEstructura
records[{column: value}, ..., {column: value}] (predeterminado)
dict{column: {index: value}}
list{column: [values]}
series{column: Series(values)}
split{index: [...], columns: [...], data: [...]}
index{index: {column: value}}

Ejemplo​

curl 'https://api.sheetbest.com/sheets/<id>?_format=records'
curl 'https://api.sheetbest.com/sheets/<id>?_format=dict'
curl 'https://api.sheetbest.com/sheets/<id>?_format=list'
curl 'https://api.sheetbest.com/sheets/<id>?_format=series'
curl 'https://api.sheetbest.com/sheets/<id>?_format=split'
curl 'https://api.sheetbest.com/sheets/<id>?_format=index'

Records (predeterminado)​

Formato records

Dict​

Formato dict

List​

Formato list

Series​

Formato series

Split​

Formato split

Index​

Formato index

Devolver tipos nativos con _raw​

Los valores de las celdas se devuelven como cadenas de texto de forma predeterminada. Añade _raw=1 para obtener números, booleanos y otros tipos JSON nativos.

# Default: values are strings
curl 'https://api.sheetbest.com/sheets/<id>'

# Native types
curl 'https://api.sheetbest.com/sheets/<id>?_raw=1'
ModoValor de ejemplo
Predeterminado (cadena)"42"
_raw=142

Salida JSON predeterminada

Salida JSON con tipos nativos

_raw se puede combinar con cualquier valor de _format.