Method: spreadsheets.values.batchClearByDataFilter

스프레드시트에서 하나 이상의 값 범위를 삭제합니다. 호출자는 스프레드시트 ID와 하나 이상의 DataFilters를 지정해야 합니다. 지정된 데이터 필터와 일치하는 범위가 삭제됩니다. 값만 지워지며 셀의 다른 모든 속성 (서식, 데이터 유효성 검사 등)은 유지됩니다.

HTTP 요청

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter

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

경로 매개변수

매개변수
spreadsheetId

string

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

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
필드
dataFilters[]

object (DataFilter)

삭제할 범위를 결정하는 데 사용되는 DataFilters입니다.

응답 본문

스프레드시트에서 DataFilters로 선택한 값의 범위를 삭제할 때의 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
필드
spreadsheetId

string

업데이트가 적용된 스프레드시트입니다.
clearedRanges[]

string

삭제된 범위(A1 표기법) 요청이 제한되지 않은 범위 또는 시트의 경계보다 큰 범위에 대한 요청인 경우, 시트의 한도로 제한된 실제 범위입니다.

승인 범위

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

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

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