Method: spreadsheets.get

Restituisce il foglio di lavoro con l'ID specificato. Il chiamante deve specificare l'ID 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 che ti interessano utilizzando il parametro URL fields in HTTP

  • Imposta il parametro URL includeGridData su true. Se viene impostata una maschera di campo, il parametro includeGridData viene ignorato

Per i fogli di lavoro di grandi dimensioni, come best practice, recupera solo i campi specifici che ti interessano.

Per recuperare solo 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 ottenere celle da 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). La limitazione dell'intervallo restituisce 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

string

Il foglio di lavoro da richiedere.

Parametri di query

Parametri
ranges[]

string

Gli intervalli da recuperare dal foglio di lavoro.
includeGridData

boolean

True se devono essere restituiti i dati della griglia. Questo parametro viene ignorato se nella richiesta è stata impostata una maschera del campo.
excludeTablesInBandedRanges

boolean

True se le tabelle devono essere escluse dagli intervalli a bande. False se non impostato.
commentsViewMode

enum (CommentsViewMode)

La modalità di visualizzazione dei commenti da applicare al foglio di lavoro. In questo modo, è possibile visualizzare il foglio di lavoro con i commenti omessi o inclusi. Se non ne viene specificato uno, viene utilizzato COMMENTS_VIEW_MODE_OMITTED.

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.