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

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