REST Resource: spreadsheets.values

리소스: ValueRange

스프레드시트 범위 내의 데이터

JSON 표현 
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
필드
range

string

값이 다루는 범위(A1 표기법) 출력의 경우, 이 범위는 요청된 전체 범위를 나타내며, 값이 후행 행과 열을 제외합니다. 값을 추가할 때 이 필드는 테이블을 검색할 범위를 나타내며 그 뒤에 값이 추가됩니다.
majorDimension

enum (Dimension)

값의 주요 측정기준입니다.

출력의 경우 스프레드시트 데이터가 A1=1,B1=2,A2=3,B2=4인 경우 range=A1:B2,majorDimension=ROWS을 요청하면 [[1,2],[3,4]]를 반환하지만 range=A1:B2,majorDimension=COLUMNS를 요청하면 [[1,3],[2,4]]를 반환합니다.

입력의 경우 range=A1:B2,majorDimension=ROWS로 설정하면 [[1,2],[3,4]]는 A1=1,B1=2,A2=3,B2=4를 설정합니다. range=A1:B2,majorDimension=COLUMNS를 사용하면 [[1,2],[3,4]]가 A1=1,B1=3,A2=2,B2=4를 설정합니다.

작성할 때 이 필드를 설정하지 않으면 기본값은 ROWS입니다.
values[]

array (ListValue format)

읽히거나 작성될 데이터입니다. 이는 배열의 배열이며, 모든 데이터를 나타내는 외부 배열과 주요 측정기준을 나타내는 각 내부 배열입니다. 내부 배열의 각 항목은 하나의 셀에 해당합니다.

출력의 경우 비어 있는 후행 행과 열은 포함되지 않습니다.

입력에 지원되는 값 유형은 bool, string, double입니다. null 값은 건너뜁니다. 셀을 빈 값으로 설정하려면 문자열 값을 빈 문자열로 설정합니다.

방법

append

 스프레드시트에 값을 추가합니다.

batchClear

 스프레드시트에서 하나 이상의 값 범위를 지웁니다.

batchClearByDataFilter

 스프레드시트에서 하나 이상의 값 범위를 지웁니다.

batchGet

 스프레드시트에서 하나 이상의 값 범위를 반환합니다.

batchGetByDataFilter

 지정된 데이터 필터와 일치하는 하나 이상의 값 범위를 반환합니다.

batchUpdate

 스프레드시트의 하나 이상의 범위에 값을 설정합니다.

batchUpdateByDataFilter

 스프레드시트의 하나 이상의 범위에 값을 설정합니다.

clear

 스프레드시트에서 값을 지웁니다.

get

 스프레드시트에서 값의 범위를 반환합니다.

update

 스프레드시트 범위에 값을 설정합니다.