스프레드시트에서 하나 이상의 값 범위를 삭제합니다. 호출자는 스프레드시트 ID와 하나 이상의 DataFilters
를 지정해야 합니다. 지정된 데이터 필터와 일치하는 범위가 삭제됩니다. 값만 삭제되며 셀의 다른 모든 속성 (예: 서식, 데이터 확인 등)은 유지됩니다.
HTTP 요청
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
spreadsheetId |
업데이트할 스프레드시트의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"dataFilters": [
{
object ( |
필드 | |
---|---|
dataFilters[] |
삭제할 범위를 결정하는 데 사용되는 |
응답 본문
스프레드시트에서 DataFilters
로 선택한 값 범위를 삭제할 때의 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
필드 | |
---|---|
spreadsheetId |
업데이트가 적용된 스프레드시트입니다. |
clearedRanges[] |
삭제된 범위(A1 표기법)입니다. 제한되지 않은 범위에 대한 요청이거나 시트의 경계보다 큰 레인저에 대한 요청인 경우, 시트의 한도로 제한된 지워진 실제 범위입니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
자세한 내용은 승인 가이드를 참조하세요.