- Richiesta HTTP
- Parametri del 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, i dati all'interno delle griglie non vengono restituiti. 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 viene impostata una maschera del campo, il parametroincludeGridData
viene ignorato
Per i fogli di lavoro di grandi dimensioni, come best practice, recupera solo i campi specifici del foglio di lavoro che preferisci.
Per recuperare solo i sottoinsiemi di dati del foglio di lavoro, utilizza il parametro URL ranges
. Gli intervalli vengono specificati utilizzando la notazione A1. Puoi definire una singola cella (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 restringi l'intervallo, vengono restituite solo le parti del foglio di lavoro che intersecano 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 |
Il foglio di lavoro da richiedere. |
Parametri di ricerca
Parametri | |
---|---|
ranges[] |
Gli intervalli da recuperare dal foglio di lavoro. |
includeGridData |
True se devono essere restituiti i 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 all'autorizzazione.