Method: spreadsheets.values.clear

스프레드시트에서 값을 삭제합니다. 호출자가 스프레드시트 ID와 범위를 지정해야 합니다. 값만 삭제되고 셀의 다른 모든 속성 (예: 서식, 데이터 유효성 검사 등)은 유지됩니다.

HTTP 요청

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

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

경로 매개변수

매개변수
spreadsheetId

string

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

string

지울 값의 A1 표기법 또는 R1C1 표기법입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

스프레드시트에서 값 범위를 지울 때의 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "spreadsheetId": string,
  "clearedRange": string
}
필드
spreadsheetId

string

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

string

삭제된 범위 (A1 표기법) (요청 범위가 경계가 없거나 시트의 경계보다 큰 경우, 이는 시트의 한도에 경계가 지정된 삭제된 실제 범위입니다.)

승인 범위

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

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

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