- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Restituisce il foglio di lavoro all'ID specificato. Il chiamante deve specificare l'ID del foglio di lavoro.
Per impostazione predefinita, non vengono restituiti i dati all'interno delle griglie. Puoi includere i dati della griglia in due modi:
Specifica una maschera di campo che elenca i campi desiderati utilizzando il parametro URL
fields
in HTTPImposta il parametro URL
includeGridData
su true. Se è impostata una maschera di campo, il parametroincludeGridData
viene ignorato
Per fogli di lavoro di grandi dimensioni, come best practice, recupera solo i campi di foglio di lavoro specifici che preferisci.
Per recuperare solo sottoinsiemi di dati dei fogli di lavoro, utilizza il parametro URL ranges
. Gli intervalli vengono specificati utilizzando la notazione A1. Puoi definire una cella singola (ad esempio A1
) o più celle (ad esempio A1:D5
). Puoi anche recuperare celle di altri fogli all'interno dello stesso foglio di lavoro (ad esempio Sheet2!A1:C4
) o recuperare più intervalli contemporaneamente (ad esempio ?ranges=A1:D5&ranges=Sheet2!A1:C4
). Se limiti l'intervallo, vengono restituite solo le parti del foglio di lavoro che si intersecano con gli intervalli richiesti.
Richiesta HTTP
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
spreadsheetId |
Foglio di lavoro da richiedere. |
Parametri di ricerca
Parametri | |
---|---|
ranges[] |
Gli intervalli da recuperare dal foglio di lavoro. |
includeGridData |
True se devono essere restituiti dati della griglia. Questo parametro viene ignorato se nella richiesta è stata impostata una maschera di campo. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Spreadsheet
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti 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
Per ulteriori informazioni, consulta la Guida alle autorizzazioni.