Method: spreadsheets.values.append

스프레드시트에 값을 추가합니다. 입력 범위는 기존 데이터를 검색하고 해당 범위 내에서 '테이블'을 찾는 데 사용됩니다. 값은 테이블의 다음 행에 추가되며 테이블의 첫 번째 열부터 시작됩니다. 표를 감지하고 데이터를 추가하는 방법에 대한 자세한 내용은 가이드 및 샘플 코드를 참조하세요.

호출자는 스프레드시트 ID, 범위 및 valueInputOption를 지정해야 합니다. valueInputOption는 입력 데이터가 시트에 추가되는 방식 (열별 또는 행별)만 제어하며 데이터가 쓰이기 시작하는 셀에 영향을 미치지 않습니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
spreadsheetId

string

업데이트할 스프레드시트의 ID입니다.
range

string

데이터의 논리 테이블을 검색하기 위한 범위의 A1 표기법입니다. 값은 테이블의 마지막 행 뒤에 추가됩니다.

쿼리 매개변수

매개변수
valueInputOption

enum (ValueInputOption)

입력 데이터의 해석 방식입니다.
insertDataOption

enum (InsertDataOption)

입력 데이터를 삽입하는 방법입니다.
includeValuesInResponse

boolean

업데이트 응답에 추가된 셀의 값이 포함되어야 하는지 결정합니다. 기본적으로 응답에는 업데이트된 값이 포함되지 않습니다.
responseValueRenderOption

enum (ValueRenderOption)

응답의 값이 렌더링되는 방식을 결정합니다. 기본 렌더링 옵션은 FORMATTED_VALUE입니다.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

응답의 날짜, 시간 및 기간을 렌더링하는 방법을 결정합니다. responseValueRenderOption가 FORMATTED_VALUE이면 무시됩니다. 기본 dateTime 렌더링 옵션은 SERIAL_NUMBER입니다.

요청 본문

요청 본문에는 ValueRange의 인스턴스가 포함됩니다.

응답 본문

스프레드시트에서 값 범위를 업데이트할 때의 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
입력란
spreadsheetId

string

업데이트가 적용된 스프레드시트
tableRange

string

값이 추가 (값이 추가되기 전)되는 테이블의 범위 (A1 표기법)입니다. 테이블을 찾을 수 없는 경우 비어 있습니다.
updates

object (UpdateValuesResponse)

적용된 업데이트에 대한 정보입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

자세한 내용은 승인 가이드를 참조하세요.

InsertDataOption

새 데이터가 입력될 때 기존 데이터가 변경되는 방식을 결정합니다.

열거형
OVERWRITE 새 데이터는 작성된 영역의 기존 데이터를 덮어씁니다. (참고: 시트 끝에 데이터를 추가하면 데이터를 쓸 수 있도록 새 행이나 열이 삽입됩니다.)
INSERT_ROWS 새 데이터에 행이 삽입됩니다.