Method: spreadsheets.values.get

Retorna um intervalo de valores de uma planilha. O autor da chamada precisa especificar o ID da planilha e um intervalo.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
spreadsheetId

string

O ID da planilha da qual os dados serão recuperados.

range

string

A notação A1 ou R1C1 do intervalo do qual os valores serão recuperados.

Parâmetros de consulta

Parâmetros
majorDimension

enum (Dimension)

A principal dimensão que os resultados devem usar.

Por exemplo, se os dados da planilha na Sheet1 forem: A1=1,B1=2,A2=3,B2=4, a solicitação de range=Sheet1!A1:B2?majorDimension=ROWS retornará [[1,2],[3,4]], enquanto a solicitação de range=Sheet1!A1:B2?majorDimension=COLUMNS retornará [[1,3],[2,4]].

valueRenderOption

enum (ValueRenderOption)

Como os valores devem ser representados na saída. A opção de renderização padrão é FORMATTED_VALUE.

dateTimeRenderOption

enum (DateTimeRenderOption)

Como datas, horas e durações precisam ser representadas na saída. Isso será ignorado se valueRenderOption for FORMATTED_VALUE. A opção de renderização padrão de dateTime é SERIAL_NUMBER.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de ValueRange.

Escopos de autorização

Requer um dos seguintes escopos do 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 mais informações, consulte o Guia de autorização.