- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébala
Muestra la hoja de cálculo con el ID determinado. El llamador debe especificar el ID de la hoja de cálculo.
De forma predeterminada, no se muestran los datos de las cuadrículas. Puedes incluir datos de cuadrícula de una de las siguientes 2 maneras:
Especifica una máscara de campo en la que se enumeren los campos deseados con el parámetro de URL
fields
en HTTP.Establece el parámetro de URL
includeGridData
en verdadero. Si se configura una máscara de campo, se ignora el parámetroincludeGridData
.
En el caso de hojas de cálculo grandes, se recomienda recuperar solo los campos específicos de la hoja de cálculo que desees.
Para recuperar solo subconjuntos de datos de hojas de cálculo, usa el parámetro de URL ranges
. Los rangos se especifican con la notación A1. Puedes definir una sola celda (por ejemplo, A1
) o varias celdas (por ejemplo, A1:D5
). También puedes obtener celdas de otras hojas dentro de la misma hoja de cálculo (por ejemplo, Sheet2!A1:C4
) o recuperar varios rangos a la vez (por ejemplo, ?ranges=A1:D5&ranges=Sheet2!A1:C4
). Si limitas el rango, solo se muestran las partes de la hoja de cálculo que se cruzan con los rangos solicitados.
Solicitud HTTP
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
spreadsheetId |
La hoja de cálculo que se solicitará. |
Parámetros de consulta
Parámetros | |
---|---|
ranges[] |
Los rangos que se recuperarán de la hoja de cálculo |
includeGridData |
Es verdadero si se deben mostrar los datos de cuadrícula. Este parámetro se ignora si se configuró una máscara de campo en la solicitud. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Spreadsheet
.
Alcances de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/spreadsheets.readonly
Para obtener más información, consulta la guía de autorización.