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)

응답의 날짜, 시간, 지속 시간이 렌더링되는 방식을 결정합니다. responseValueRenderOptionFORMATTED_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 새 데이터에 행이 삽입됩니다.