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

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