Method: spreadsheets.values.update
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 )
응답의 날짜, 시간 및 기간을 렌더링하는 방법을 결정합니다. responseValueRenderOption 가 FORMATTED_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
자세한 내용은 승인 가이드를 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-05(UTC)
[null,null,["최종 업데이트: 2024-09-05(UTC)"],[[["This method allows you to set values within a specified range of a Google Sheet using the provided spreadsheet ID, range, and value input option."],["You can control data interpretation, response inclusion of updated values, value rendering, and date/time rendering through query parameters."],["The request body requires a ValueRange object defining the values to be set, while a successful response returns an UpdateValuesResponse object."],["Authorization is necessary using one of the specified OAuth scopes: `https://www.googleapis.com/auth/drive`, `https://www.googleapis.com/auth/drive.file`, or `https://www.googleapis.com/auth/spreadsheets`."]]],["This outlines updating spreadsheet values using a `PUT` request to the Google Sheets API. Key actions include specifying the `spreadsheetId` and `range` in the URL's path parameters. The request requires a `valueInputOption` in the query parameters to define data interpretation. Optional query parameters allow controlling response content and formatting. The request body uses `ValueRange`, and a successful response includes `UpdateValuesResponse`. Authorization requires specific OAuth scopes: `drive`, `drive.file`, or `spreadsheets`.\n"]]