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)

읽거나 쓸 데이터입니다. 배열의 배열로, 외부 배열은 모든 데이터를 나타내고 각 내부 배열은 주요 측정기준을 나타냅니다. 내부 배열의 각 항목은 하나의 셀에 해당합니다.

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

입력의 경우 지원되는 값 유형은 불리언, 문자열, double입니다. null 값은 건너뜁니다. 셀을 빈 값으로 설정하려면 문자열 값을 빈 문자열로 설정합니다.

메서드

append

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

batchClear

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

batchClearByDataFilter

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

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

스프레드시트에서 값을 삭제합니다.

get

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

update

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