Method: spreadsheets.values.get

Restituisce un intervallo di valori da un foglio di lavoro. L'utente che chiama deve specificare l'ID foglio di lavoro e un intervallo.

Richiesta HTTP

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
spreadsheetId

string

L'ID del foglio di lavoro da cui recuperare i dati.
range

string

La notazione A1 o R1C1 dell'intervallo da cui recuperare i valori.

Parametri di query

Parametri
majorDimension

enum (Dimension)

La dimensione principale che devono utilizzare i risultati.

Ad esempio, se i dati del foglio di lavoro in Foglio1 sono: A1=1,B1=2,A2=3,B2=4, la richiesta di range=Sheet1!A1:B2?majorDimension=ROWS restituisce [[1,2],[3,4]], mentre la richiesta di range=Sheet1!A1:B2?majorDimension=COLUMNS restituisce [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

La modalità di rappresentazione dei valori nell'output. L'opzione di rendering predefinita è FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

La modalità di rappresentazione di date, orari e durate nell'output. Questo valore viene ignorato se valueRenderOption è FORMATTED_VALUE. L'opzione di visualizzazione predefinita per dateTime è SERIAL_NUMBER.

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 ValueRange.

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.