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

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