Method: spreadsheets.values.update

스프레드시트 범위에 값을 설정합니다. 호출자는 스프레드시트 ID, 범위 및 valueInputOption를 지정해야 합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
spreadsheetId

string

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

range

string

업데이트할 값의 A1 표기법입니다.

쿼리 매개변수

매개변수
valueInputOption

enum (ValueInputOption)

입력 데이터가 해석되는 방식입니다.

includeValuesInResponse

boolean

업데이트 응답에 업데이트된 셀의 값을 포함할지 결정합니다. 기본적으로 응답에는 업데이트된 값이 포함되지 않습니다. 쓰기 범위가 실제 쓰기 범위보다 큰 경우 응답에는 요청된 범위의 모든 값이 포함됩니다 (후행 빈 행과 열 제외).

responseValueRenderOption

enum (ValueRenderOption)

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

responseDateTimeRenderOption

enum (DateTimeRenderOption)

응답의 날짜, 시간, 지속 시간이 렌더링되는 방식을 결정합니다. responseValueRenderOptionFORMATTED_VALUE이면 무시됩니다. 기본 dateTime 렌더링 옵션은 SERIAL_NUMBER입니다.

요청 본문

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

응답 본문

성공한 경우 응답 본문에 UpdateValuesResponse의 인스턴스가 포함됩니다.

승인 범위

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

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

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