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 새 데이터에 행이 삽입됩니다.