Google Sheets

제공 도구 19

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

• google_sheets__append_overwrite파괴적승인 필요

  ⚠️ INSERT_ROWS 없이 표 뒤에 쓰므로 기존 셀을 덮어쓸 수 있다(OVERWRITE). ⚠️ 기존 값·구조를 바꾼다. 되돌리려면 변경 전 데이터·서식 사본으로 다시 써야 한다. 결과: 변경 범위·개수 등 공식 JSON.

• google_sheets__batch_clear파괴적승인 필요

  Google Sheets sheets.spreadsheets.values.batchClear를 실행한다. body에는 공식 요청 필드 이름을 사용한다. ⚠️ 기존 값·구조를 바꾼다. 되돌리려면 변경 전 데이터·서식 사본으로 다시 써야 한다. 결과: 변경 범위·개수 등 공식 JSON.

• google_sheets__batch_clear_by_data_filter파괴적승인 필요

  Google Sheets sheets.spreadsheets.values.batchClearByDataFilter를 실행한다. body에는 공식 요청 필드 이름을 사용한다. ⚠️ 기존 값·구조를 바꾼다. 되돌리려면 변경 전 데이터·서식 사본으로 다시 써야 한다. 결과: 변경 범위·개수 등 공식 JSON.

• google_sheets__batch_update파괴적승인 필요

  ⚠️ 시트 탭·서식·차트·범위·메타데이터를 일괄 변경한다. 모든 내부 요청을 서버에서 검사한다. 댓글·보호범위·외부 데이터소스 요청은 지원하지 않는다. ⚠️ 기존 값·구조를 바꾼다. 되돌리려면 변경 전 데이터·서식 사본으로 다시 써야 한다. 결과: 변경 범위·개수 등 공식 JSON.

• google_sheets__batch_update_by_data_filter파괴적승인 필요

  Google Sheets sheets.spreadsheets.values.batchUpdateByDataFilter를 실행한다. body에는 공식 요청 필드 이름을 사용한다. ⚠️ 기존 값·구조를 바꾼다. 되돌리려면 변경 전 데이터·서식 사본으로 다시 써야 한다. 결과: 변경 범위·개수 등 공식 JSON.

• google_sheets__batch_update_values파괴적승인 필요

  Google Sheets sheets.spreadsheets.values.batchUpdate를 실행한다. body에는 공식 요청 필드 이름을 사용한다. ⚠️ 기존 값·구조를 바꾼다. 되돌리려면 변경 전 데이터·서식 사본으로 다시 써야 한다. 결과: 변경 범위·개수 등 공식 JSON.

• google_sheets__clear파괴적승인 필요

  Google Sheets sheets.spreadsheets.values.clear를 실행한다. body에는 공식 요청 필드 이름을 사용한다. ⚠️ 기존 값·구조를 바꾼다. 되돌리려면 변경 전 데이터·서식 사본으로 다시 써야 한다. 결과: 변경 범위·개수 등 공식 JSON.

• google_sheets__delete파괴적승인 필요

  ⚠️ 파일 전체를 Drive 휴지통으로 이동한다. drive.file 권한으로 이 연결이 만들거나 연 파일만 가능하다. Drive 휴지통에서 파일을 복원할 수 있다. 결과: trashed · file_id.

• google_sheets__update파괴적승인 필요

  ⚠️ 범위의 기존 값을 덮어쓴다. RAW/USER_ENTERED, 행/열 및 응답 렌더링 지원. ⚠️ 기존 값·구조를 바꾼다. 되돌리려면 변경 전 데이터·서식 사본으로 다시 써야 한다. 결과: 변경 범위·개수 등 공식 JSON.

• google_sheets__copy_to발신승인 필요

  다른 스프레드시트로 시트 탭을 복사한다. 대상 파일 협업자에게 데이터가 공개될 수 있어 발신 승인이 필요하다. ⚠️ 대상 파일 협업자에게 내용이 공개되며 이미 본 내용은 회수할 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다. 결과: 복사한 시트 탭 속성.

• google_sheets__append쓰기

  표 끝에 행 추가(INSERT_ROWS). RAW/USER_ENTERED 및 숫자·불리언·빈 셀 지원. 결과: 공식 JSON 또는 범위의 셀 값.

• google_sheets__create쓰기

  새 스프레드시트 생성. title/sheet_title 또는 공식 Spreadsheet body를 입력한다. 결과: 공식 JSON 또는 범위의 셀 값.

• google_sheets__batch_get읽기

  Google Sheets sheets.spreadsheets.values.batchGet를 실행한다. body에는 공식 요청 필드 이름을 사용한다. 결과: 공식 JSON 또는 범위의 셀 값.

• google_sheets__batch_get_by_data_filter읽기

  Google Sheets sheets.spreadsheets.values.batchGetByDataFilter를 실행한다. body에는 공식 요청 필드 이름을 사용한다. 결과: 공식 JSON 또는 범위의 셀 값.

• google_sheets__get_by_data_filter읽기

  Google Sheets sheets.spreadsheets.getByDataFilter를 실행한다. body에는 공식 요청 필드 이름을 사용한다. 결과: 공식 JSON 또는 범위의 셀 값.

• google_sheets__get_metadata읽기

  Google Sheets sheets.spreadsheets.developerMetadata.get를 실행한다. body에는 공식 요청 필드 이름을 사용한다. 결과: 공식 JSON 또는 범위의 셀 값.

• google_sheets__info읽기

  시트 탭 ID·구조·서식 조회. ranges, includeGridData, fields 및 전체 원문 spreadsheet를 지원한다. 결과: 공식 JSON 또는 범위의 셀 값.

• google_sheets__read읽기

  범위 읽기. 렌더링·행/열 옵션 지원. response_format=json은 공식 ValueRange를 반환한다. 결과: 공식 JSON 또는 범위의 셀 값.

• google_sheets__search_metadata읽기

  Google Sheets sheets.spreadsheets.developerMetadata.search를 실행한다. body에는 공식 요청 필드 이름을 사용한다. 결과: 공식 JSON 또는 범위의 셀 값.

연동 준비

1. Google Sheets access: Google Sheets v4 supports values, filters, metadata, sheet copy and supported structural batches. Required scopes: https://www.googleapis.com/auth/spreadsheets and https://www.googleapis.com/auth/drive.file (trash only). Existing tokens do not gain permissions from database updates. If a scope is missing, reconnect Google Sheets and grant consent again. File access, Sheets API enablement and Workspace policy may also cause HTTP 403. 바로가기