InfoGrab Docs

Google Sheets 문서 내 시트 작업

요약

이 작업을 사용하여 Google Sheets에서 Google 스프레드시트의 시트를 생성, 업데이트, 지우기 또는 삭제합니다. 이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다. 이 작업을 사용하여 기존 행을 업데이트하거나, 시트에서 일치하는 항목을 찾을 수 없는 경우 데이터 끝에 새 행을 추가합니다.

이 작업을 사용하여 Google Sheets에서 Google 스프레드시트의 시트를 생성, 업데이트, 지우기 또는 삭제합니다. Google Sheets 노드 자체에 대한 자세한 내용은 Google Sheets를 참조하세요.

이 노드는 AI 도구로 사용할 수 있습니다

이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다. 이 방식으로 사용하면 많은 파라미터를 자동으로 설정하거나 AI가 제공하는 정보로 설정할 수 있습니다. 자세한 내용은 AI 도구 파라미터 문서를 참조하세요.

행 추가 또는 업데이트#

이 작업을 사용하여 기존 행을 업데이트하거나, 시트에서 일치하는 항목을 찾을 수 없는 경우 데이터 끝에 새 행을 추가합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 추가 또는 업데이트를 선택합니다.
  • 문서: 행을 추가하거나 업데이트할 시트가 포함된 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 행을 추가하거나 업데이트할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 제목을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 매핑 열 모드:
    • 각 열 수동 매핑: 각 열에 대해 전송할 값을 입력합니다.
    • 자동 매핑: n8n이 Google Sheets의 열과 일치하는 입력 데이터를 자동으로 찾습니다. 이 모드에서는 입력 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 앞에 필드 편집 노드를 사용하여 변경하세요.)
    • 없음: 데이터를 매핑하지 않습니다.

옵션#

  • Cell Format: 셀의 데이터 형식을 지정하는 방법을 선택합니다. 자세한 내용은 Google Sheets API | CellFormat을 참조하세요.
    • Let Google Sheets format (기본값): n8n이 Google Sheets의 기본 설정에 따라 셀의 텍스트와 숫자를 형식화합니다.
    • Let n8n format: 시트의 새 셀에 n8n이 제공하는 입력 데이터와 동일한 데이터 타입이 적용됩니다.
  • Data Location on Sheet: 시트에서 데이터 범위를 지정해야 할 때 이 옵션을 사용합니다.
    • Header Row: 열 헤더가 포함된 행 인덱스를 지정합니다.
    • First Data Row: 실제 데이터가 시작되는 행 인덱스를 지정합니다.
  • Handling extra fields in input: Mapping Column Mode > Map Automatically 사용 시, 시트의 기존 열과 일치하지 않는 입력 데이터의 필드 처리 방법을 결정하는 데 이 옵션을 사용합니다.
    • Insert in New Column(s) (기본값): 추가 데이터를 위한 새 열을 추가합니다.
    • Ignore Them: 기존 열과 일치하지 않는 추가 데이터를 무시합니다.
    • Error: 오류를 발생시키고 실행을 중단합니다.
  • Use Append: 새 데이터 행을 추가할 때 Google API append 엔드포인트를 사용하려면 이 옵션을 켭니다.
    • 기본적으로 n8n은 빈 행 또는 열을 추가한 다음 새 데이터를 추가합니다. 이 방식은 데이터 정렬을 보장하지만 효율성이 낮을 수 있습니다. append 엔드포인트를 사용하면 API 호출 수를 최소화하고 프로세스를 간소화하여 성능을 향상시킬 수 있습니다. 그러나 기존 시트 데이터에 행과 열 사이의 간격이나 끊김 같은 불일치가 있으면 n8n이 잘못된 위치에 새 데이터를 추가하여 정렬 문제가 발생할 수 있습니다.
    • 성능이 우선이고 시트의 데이터 구조가 간격 없이 일관된 경우 이 옵션을 사용하세요.

자세한 내용은 Method: spreadsheets.values.update | Google Sheets API 문서를 참조하세요.

행 추가#

이 작업을 사용하여 시트의 데이터 끝에 새 행을 추가합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 추가를 선택합니다.
  • 문서: 행을 추가할 시트가 있는 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 행을 추가할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 제목을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 매핑 열 모드:
    • 각 열 수동 매핑: 업데이트할 행을 찾을 때 일치시킬 열을 선택합니다. 각 열에 대해 전송할 값을 입력합니다.
    • 자동 매핑: n8n이 Google Sheets의 열과 일치하는 입력 데이터를 자동으로 찾습니다. 이 모드에서는 입력 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 앞에 필드 편집 노드를 사용하여 변경하세요.)
    • 없음: 데이터를 매핑하지 않습니다.

옵션#

  • Cell Format: 셀의 데이터 형식을 지정하는 방법을 선택합니다. 자세한 내용은 Google Sheets API | CellFormat을 참조하세요.
    • Let Google Sheets format (기본값): n8n이 Google Sheets의 기본 설정에 따라 셀의 텍스트와 숫자를 형식화합니다.
    • Let n8n format: 시트의 새 셀에 n8n이 제공하는 입력 데이터와 동일한 데이터 타입이 적용됩니다.
  • Data Location on Sheet: 시트에서 데이터 범위를 지정해야 할 때 이 옵션을 사용합니다.
    • Header Row: 열 헤더가 포함된 행 인덱스를 지정합니다.
    • First Data Row: 실제 데이터가 시작되는 행 인덱스를 지정합니다.
  • Handling extra fields in input: Mapping Column Mode > Map Automatically 사용 시, 시트의 기존 열과 일치하지 않는 입력 데이터의 필드 처리 방법을 결정하는 데 이 옵션을 사용합니다.
    • Insert in New Column(s) (기본값): 추가 데이터를 위한 새 열을 추가합니다.
    • Ignore Them: 기존 열과 일치하지 않는 추가 데이터를 무시합니다.
    • Error: 오류를 발생시키고 실행을 중단합니다.
  • Use Append: 새 데이터 행을 추가할 때 Google API append 엔드포인트를 사용하려면 이 옵션을 켭니다.
    • 기본적으로 n8n은 빈 행 또는 열을 추가한 다음 새 데이터를 추가합니다. 이 방식은 데이터 정렬을 보장하지만 효율성이 낮을 수 있습니다. append 엔드포인트를 사용하면 API 호출 수를 최소화하고 프로세스를 간소화하여 성능을 향상시킬 수 있습니다. 그러나 기존 시트 데이터에 행과 열 사이의 간격이나 끊김 같은 불일치가 있으면 n8n이 잘못된 위치에 새 데이터를 추가하여 정렬 문제가 발생할 수 있습니다.
    • 성능이 우선이고 시트의 데이터 구조가 간격 없이 일관된 경우 이 옵션을 사용하세요.

자세한 내용은 Method: spreadsheets.values.append | Google Sheets API 문서를 참조하세요.

시트 지우기#

이 작업을 사용하여 시트의 모든 데이터를 지웁니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 지우기를 선택합니다.
  • 문서: 데이터를 지울 시트가 있는 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 데이터를 지울 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 제목을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 지우기: 시트에서 지울 데이터를 선택합니다.
    • 전체 시트: 시트의 모든 데이터를 지웁니다. 첫 번째 행 유지를 켜면 시트의 첫 번째 행이 유지됩니다.
    • 특정 행: 특정 행의 데이터를 지웁니다. 다음도 입력합니다:
      • 시작 행 번호: 지울 첫 번째 행 번호를 입력합니다.
      • 삭제할 행 수: 지울 행 수를 입력합니다. 1은 시작 행 번호의 행 데이터만 지웁니다.
    • 특정 열: 특정 열의 데이터를 지웁니다. 다음도 입력합니다:
      • 시작 열: 문자 표기법을 사용하여 지울 첫 번째 열을 입력합니다.
      • 삭제할 열 수: 지울 열 수를 입력합니다. 1은 시작 열의 데이터만 지웁니다.
    • 특정 범위: A1 표기법으로 데이터를 지울 테이블 범위를 입력합니다.

자세한 내용은 Method: spreadsheets.values.clear | Google Sheets API 문서를 참조하세요.

새 시트 생성#

이 작업을 사용하여 새 시트를 생성합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 생성을 선택합니다.
  • 문서: 새 시트를 생성할 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 제목: 새 시트의 제목을 입력합니다.

옵션#

  • 숨기기: 이 옵션을 켜면 UI에서 시트를 숨겨 둡니다.
  • 오른쪽에서 왼쪽으로: 이 옵션을 켜면 LTR 시트 대신 RTL 시트를 사용합니다.
  • 시트 ID: 시트의 ID를 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
  • 시트 인덱스: 기본적으로 새 시트는 스프레드시트의 마지막 시트입니다. 이 동작을 재정의하려면 새 시트에 사용할 인덱스를 입력합니다. 지정된 인덱스에 시트를 추가하면 Google이 이후 모든 시트의 인덱스를 증가시킵니다. 자세한 내용은 Sheets | SheetProperties 문서를 참조하세요.
  • 탭 색상: 16진수 코드로 색상을 입력하거나 색상 선택기를 사용하여 UI에서 탭 색상을 설정합니다.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

시트 삭제#

이 작업을 사용하여 시트를 영구적으로 삭제합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 삭제를 선택합니다.
  • 문서: 삭제할 시트가 포함된 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 삭제할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 이름을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 또는 열 삭제#

이 작업을 사용하여 시트에서 행이나 열을 삭제합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 또는 열 삭제를 선택합니다.
  • 문서: 행이나 열을 삭제할 시트가 포함된 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 행이나 열을 삭제할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 이름을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 시작 행 번호 또는 시작 열: 삭제를 시작할 행 번호 또는 열 문자를 입력합니다.
  • 삭제할 행 수 또는 삭제할 열 수: 삭제할 행이나 열의 수를 입력합니다.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 가져오기#

이 작업을 사용하여 시트에서 하나 이상의 행을 읽습니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 가져오기를 선택합니다.
  • 문서: 행을 가져올 시트가 포함된 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 행을 읽을 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 이름을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 필터: 기본적으로 노드는 시트의 모든 행을 반환합니다. 제한된 결과를 반환하려면 필터를 설정하세요:
    • 열: 검색할 시트의 열을 선택합니다.
    • 값: 검색할 셀 값을 입력합니다. 입력 데이터 매개변수를 여기로 드래그할 수 있습니다. 필터가 여러 행과 일치하는 경우 n8n은 첫 번째 결과를 반환합니다. 모든 일치 행을 원하는 경우:
      1. 옵션 아래에서 옵션 추가 > 필터에 여러 일치 항목이 있을 때를 선택합니다.
      2. 필터에 여러 일치 항목이 있을 때를 모든 일치 항목 반환으로 변경합니다.

옵션#

  • 시트의 데이터 위치: 이 옵션을 사용하여 데이터 범위를 지정합니다. 기본적으로 n8n은 시트의 마지막 행까지 범위를 자동으로 감지합니다.
  • 출력 형식: 이 옵션을 사용하여 n8n이 Google Sheets에서 반환된 데이터를 형식화하는 방법을 선택합니다.
    • 일반 형식:
      • 값 (서식 없음) (기본값): n8n이 통화 기호 및 기타 특수 서식을 제거합니다. 데이터 유형은 숫자로 유지됩니다.
      • 값 (서식 있음): n8n이 데이터 유형을 숫자에서 문자열로 변환하여 Google Sheets에 표시되는 대로(예: 쉼표나 통화 기호 유지) 값을 표시합니다.
      • 수식: n8n이 수식을 반환합니다. 수식 출력을 계산하지 않습니다. 예를 들어 셀 B2에 수식 =A2가 있는 경우 n8n은 B2의 값을 =A2(텍스트)로 반환합니다. 자세한 내용은 날짜 및 시간 값 정보 | Google Sheets를 참조하세요.
    • 날짜 형식: 자세한 내용은 DateTimeRenderOption | Google Sheets를 참조하세요.
      • 형식화된 텍스트 (기본값): 스프레드시트 로케일에 따라 Google Sheets에 표시되는 대로. 예를 들어 01/01/2024.
      • 일련 번호: 1899년 12월 30일 이후 일수.
    • 필터에 여러 일치 항목이 있을 때: 여러 일치 항목을 가져오려면 모든 일치 항목 반환으로 설정합니다. 기본적으로 첫 번째 결과만 반환됩니다.
첫 번째 행

n8n은 Google Sheet의 첫 번째 행을 제목 행으로 처리하며, 모든 행을 읽을 때 반환하지 않습니다. 첫 번째 행을 읽으려면 옵션을 사용하여 시트의 데이터 위치를 설정하세요.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 업데이트#

이 작업을 사용하여 시트의 기존 행을 업데이트합니다. 이 작업은 기존 행만 업데이트합니다. 시트에서 일치하는 항목을 찾을 수 없는 경우 행을 추가하려면 행 추가 또는 업데이트 작업을 대신 사용하세요.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 업데이트를 선택합니다.
  • 문서: 업데이트할 시트가 있는 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 업데이트할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 제목을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 매핑 열 모드:
    • 각 열 수동 매핑: 각 열에 대해 전송할 값을 입력합니다.
    • 자동 매핑: n8n이 Google Sheets의 열과 일치하는 입력 데이터를 자동으로 찾습니다. 이 모드에서는 입력 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 앞에 필드 편집 노드를 사용하여 변경하세요.)
    • 없음: 데이터를 매핑하지 않습니다.

옵션#

  • 셀 형식: 이 옵션을 사용하여 셀의 데이터를 형식화하는 방법을 선택합니다. 자세한 내용은 Google Sheets API | CellFormat을 참조하세요.
    • Google Sheets가 형식화 (기본값): n8n이 Google Sheets의 기본 설정에 따라 셀의 텍스트와 숫자를 형식화합니다.
    • n8n이 형식화: 시트의 새 셀에 n8n이 제공하는 입력 데이터와 동일한 데이터 유형이 사용됩니다.
  • 시트의 데이터 위치: 시트에서 데이터 범위를 지정해야 할 때 이 옵션을 사용합니다.
    • 헤더 행: 열 헤더가 포함된 행 인덱스를 지정합니다.
    • 첫 번째 데이터 행: 실제 데이터가 시작되는 행 인덱스를 지정합니다.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

Google Sheets 문서 내 시트 작업

원문 보기
요약

이 작업을 사용하여 Google Sheets에서 Google 스프레드시트의 시트를 생성, 업데이트, 지우기 또는 삭제합니다. 이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다. 이 작업을 사용하여 기존 행을 업데이트하거나, 시트에서 일치하는 항목을 찾을 수 없는 경우 데이터 끝에 새 행을 추가합니다.

이 작업을 사용하여 Google Sheets에서 Google 스프레드시트의 시트를 생성, 업데이트, 지우기 또는 삭제합니다. Google Sheets 노드 자체에 대한 자세한 내용은 Google Sheets를 참조하세요.

이 노드는 AI 도구로 사용할 수 있습니다

이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다. 이 방식으로 사용하면 많은 파라미터를 자동으로 설정하거나 AI가 제공하는 정보로 설정할 수 있습니다. 자세한 내용은 AI 도구 파라미터 문서를 참조하세요.

행 추가 또는 업데이트#

이 작업을 사용하여 기존 행을 업데이트하거나, 시트에서 일치하는 항목을 찾을 수 없는 경우 데이터 끝에 새 행을 추가합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 추가 또는 업데이트를 선택합니다.
  • 문서: 행을 추가하거나 업데이트할 시트가 포함된 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 행을 추가하거나 업데이트할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 제목을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 매핑 열 모드:
    • 각 열 수동 매핑: 각 열에 대해 전송할 값을 입력합니다.
    • 자동 매핑: n8n이 Google Sheets의 열과 일치하는 입력 데이터를 자동으로 찾습니다. 이 모드에서는 입력 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 앞에 필드 편집 노드를 사용하여 변경하세요.)
    • 없음: 데이터를 매핑하지 않습니다.

옵션#

  • Cell Format: 셀의 데이터 형식을 지정하는 방법을 선택합니다. 자세한 내용은 Google Sheets API | CellFormat을 참조하세요.
    • Let Google Sheets format (기본값): n8n이 Google Sheets의 기본 설정에 따라 셀의 텍스트와 숫자를 형식화합니다.
    • Let n8n format: 시트의 새 셀에 n8n이 제공하는 입력 데이터와 동일한 데이터 타입이 적용됩니다.
  • Data Location on Sheet: 시트에서 데이터 범위를 지정해야 할 때 이 옵션을 사용합니다.
    • Header Row: 열 헤더가 포함된 행 인덱스를 지정합니다.
    • First Data Row: 실제 데이터가 시작되는 행 인덱스를 지정합니다.
  • Handling extra fields in input: Mapping Column Mode > Map Automatically 사용 시, 시트의 기존 열과 일치하지 않는 입력 데이터의 필드 처리 방법을 결정하는 데 이 옵션을 사용합니다.
    • Insert in New Column(s) (기본값): 추가 데이터를 위한 새 열을 추가합니다.
    • Ignore Them: 기존 열과 일치하지 않는 추가 데이터를 무시합니다.
    • Error: 오류를 발생시키고 실행을 중단합니다.
  • Use Append: 새 데이터 행을 추가할 때 Google API append 엔드포인트를 사용하려면 이 옵션을 켭니다.
    • 기본적으로 n8n은 빈 행 또는 열을 추가한 다음 새 데이터를 추가합니다. 이 방식은 데이터 정렬을 보장하지만 효율성이 낮을 수 있습니다. append 엔드포인트를 사용하면 API 호출 수를 최소화하고 프로세스를 간소화하여 성능을 향상시킬 수 있습니다. 그러나 기존 시트 데이터에 행과 열 사이의 간격이나 끊김 같은 불일치가 있으면 n8n이 잘못된 위치에 새 데이터를 추가하여 정렬 문제가 발생할 수 있습니다.
    • 성능이 우선이고 시트의 데이터 구조가 간격 없이 일관된 경우 이 옵션을 사용하세요.

자세한 내용은 Method: spreadsheets.values.update | Google Sheets API 문서를 참조하세요.

행 추가#

이 작업을 사용하여 시트의 데이터 끝에 새 행을 추가합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 추가를 선택합니다.
  • 문서: 행을 추가할 시트가 있는 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 행을 추가할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 제목을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 매핑 열 모드:
    • 각 열 수동 매핑: 업데이트할 행을 찾을 때 일치시킬 열을 선택합니다. 각 열에 대해 전송할 값을 입력합니다.
    • 자동 매핑: n8n이 Google Sheets의 열과 일치하는 입력 데이터를 자동으로 찾습니다. 이 모드에서는 입력 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 앞에 필드 편집 노드를 사용하여 변경하세요.)
    • 없음: 데이터를 매핑하지 않습니다.

옵션#

  • Cell Format: 셀의 데이터 형식을 지정하는 방법을 선택합니다. 자세한 내용은 Google Sheets API | CellFormat을 참조하세요.
    • Let Google Sheets format (기본값): n8n이 Google Sheets의 기본 설정에 따라 셀의 텍스트와 숫자를 형식화합니다.
    • Let n8n format: 시트의 새 셀에 n8n이 제공하는 입력 데이터와 동일한 데이터 타입이 적용됩니다.
  • Data Location on Sheet: 시트에서 데이터 범위를 지정해야 할 때 이 옵션을 사용합니다.
    • Header Row: 열 헤더가 포함된 행 인덱스를 지정합니다.
    • First Data Row: 실제 데이터가 시작되는 행 인덱스를 지정합니다.
  • Handling extra fields in input: Mapping Column Mode > Map Automatically 사용 시, 시트의 기존 열과 일치하지 않는 입력 데이터의 필드 처리 방법을 결정하는 데 이 옵션을 사용합니다.
    • Insert in New Column(s) (기본값): 추가 데이터를 위한 새 열을 추가합니다.
    • Ignore Them: 기존 열과 일치하지 않는 추가 데이터를 무시합니다.
    • Error: 오류를 발생시키고 실행을 중단합니다.
  • Use Append: 새 데이터 행을 추가할 때 Google API append 엔드포인트를 사용하려면 이 옵션을 켭니다.
    • 기본적으로 n8n은 빈 행 또는 열을 추가한 다음 새 데이터를 추가합니다. 이 방식은 데이터 정렬을 보장하지만 효율성이 낮을 수 있습니다. append 엔드포인트를 사용하면 API 호출 수를 최소화하고 프로세스를 간소화하여 성능을 향상시킬 수 있습니다. 그러나 기존 시트 데이터에 행과 열 사이의 간격이나 끊김 같은 불일치가 있으면 n8n이 잘못된 위치에 새 데이터를 추가하여 정렬 문제가 발생할 수 있습니다.
    • 성능이 우선이고 시트의 데이터 구조가 간격 없이 일관된 경우 이 옵션을 사용하세요.

자세한 내용은 Method: spreadsheets.values.append | Google Sheets API 문서를 참조하세요.

시트 지우기#

이 작업을 사용하여 시트의 모든 데이터를 지웁니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 지우기를 선택합니다.
  • 문서: 데이터를 지울 시트가 있는 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 데이터를 지울 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 제목을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 지우기: 시트에서 지울 데이터를 선택합니다.
    • 전체 시트: 시트의 모든 데이터를 지웁니다. 첫 번째 행 유지를 켜면 시트의 첫 번째 행이 유지됩니다.
    • 특정 행: 특정 행의 데이터를 지웁니다. 다음도 입력합니다:
      • 시작 행 번호: 지울 첫 번째 행 번호를 입력합니다.
      • 삭제할 행 수: 지울 행 수를 입력합니다. 1은 시작 행 번호의 행 데이터만 지웁니다.
    • 특정 열: 특정 열의 데이터를 지웁니다. 다음도 입력합니다:
      • 시작 열: 문자 표기법을 사용하여 지울 첫 번째 열을 입력합니다.
      • 삭제할 열 수: 지울 열 수를 입력합니다. 1은 시작 열의 데이터만 지웁니다.
    • 특정 범위: A1 표기법으로 데이터를 지울 테이블 범위를 입력합니다.

자세한 내용은 Method: spreadsheets.values.clear | Google Sheets API 문서를 참조하세요.

새 시트 생성#

이 작업을 사용하여 새 시트를 생성합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 생성을 선택합니다.
  • 문서: 새 시트를 생성할 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 제목: 새 시트의 제목을 입력합니다.

옵션#

  • 숨기기: 이 옵션을 켜면 UI에서 시트를 숨겨 둡니다.
  • 오른쪽에서 왼쪽으로: 이 옵션을 켜면 LTR 시트 대신 RTL 시트를 사용합니다.
  • 시트 ID: 시트의 ID를 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
  • 시트 인덱스: 기본적으로 새 시트는 스프레드시트의 마지막 시트입니다. 이 동작을 재정의하려면 새 시트에 사용할 인덱스를 입력합니다. 지정된 인덱스에 시트를 추가하면 Google이 이후 모든 시트의 인덱스를 증가시킵니다. 자세한 내용은 Sheets | SheetProperties 문서를 참조하세요.
  • 탭 색상: 16진수 코드로 색상을 입력하거나 색상 선택기를 사용하여 UI에서 탭 색상을 설정합니다.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

시트 삭제#

이 작업을 사용하여 시트를 영구적으로 삭제합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 삭제를 선택합니다.
  • 문서: 삭제할 시트가 포함된 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 삭제할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 이름을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 또는 열 삭제#

이 작업을 사용하여 시트에서 행이나 열을 삭제합니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 또는 열 삭제를 선택합니다.
  • 문서: 행이나 열을 삭제할 시트가 포함된 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 행이나 열을 삭제할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 이름을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 시작 행 번호 또는 시작 열: 삭제를 시작할 행 번호 또는 열 문자를 입력합니다.
  • 삭제할 행 수 또는 삭제할 열 수: 삭제할 행이나 열의 수를 입력합니다.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 가져오기#

이 작업을 사용하여 시트에서 하나 이상의 행을 읽습니다.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 가져오기를 선택합니다.
  • 문서: 행을 가져올 시트가 포함된 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 행을 읽을 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 이름을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 필터: 기본적으로 노드는 시트의 모든 행을 반환합니다. 제한된 결과를 반환하려면 필터를 설정하세요:
    • 열: 검색할 시트의 열을 선택합니다.
    • 값: 검색할 셀 값을 입력합니다. 입력 데이터 매개변수를 여기로 드래그할 수 있습니다. 필터가 여러 행과 일치하는 경우 n8n은 첫 번째 결과를 반환합니다. 모든 일치 행을 원하는 경우:
      1. 옵션 아래에서 옵션 추가 > 필터에 여러 일치 항목이 있을 때를 선택합니다.
      2. 필터에 여러 일치 항목이 있을 때를 모든 일치 항목 반환으로 변경합니다.

옵션#

  • 시트의 데이터 위치: 이 옵션을 사용하여 데이터 범위를 지정합니다. 기본적으로 n8n은 시트의 마지막 행까지 범위를 자동으로 감지합니다.
  • 출력 형식: 이 옵션을 사용하여 n8n이 Google Sheets에서 반환된 데이터를 형식화하는 방법을 선택합니다.
    • 일반 형식:
      • 값 (서식 없음) (기본값): n8n이 통화 기호 및 기타 특수 서식을 제거합니다. 데이터 유형은 숫자로 유지됩니다.
      • 값 (서식 있음): n8n이 데이터 유형을 숫자에서 문자열로 변환하여 Google Sheets에 표시되는 대로(예: 쉼표나 통화 기호 유지) 값을 표시합니다.
      • 수식: n8n이 수식을 반환합니다. 수식 출력을 계산하지 않습니다. 예를 들어 셀 B2에 수식 =A2가 있는 경우 n8n은 B2의 값을 =A2(텍스트)로 반환합니다. 자세한 내용은 날짜 및 시간 값 정보 | Google Sheets를 참조하세요.
    • 날짜 형식: 자세한 내용은 DateTimeRenderOption | Google Sheets를 참조하세요.
      • 형식화된 텍스트 (기본값): 스프레드시트 로케일에 따라 Google Sheets에 표시되는 대로. 예를 들어 01/01/2024.
      • 일련 번호: 1899년 12월 30일 이후 일수.
    • 필터에 여러 일치 항목이 있을 때: 여러 일치 항목을 가져오려면 모든 일치 항목 반환으로 설정합니다. 기본적으로 첫 번째 결과만 반환됩니다.
첫 번째 행

n8n은 Google Sheet의 첫 번째 행을 제목 행으로 처리하며, 모든 행을 읽을 때 반환하지 않습니다. 첫 번째 행을 읽으려면 옵션을 사용하여 시트의 데이터 위치를 설정하세요.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 업데이트#

이 작업을 사용하여 시트의 기존 행을 업데이트합니다. 이 작업은 기존 행만 업데이트합니다. 시트에서 일치하는 항목을 찾을 수 없는 경우 행을 추가하려면 행 추가 또는 업데이트 작업을 대신 사용하세요.

다음 매개변수를 입력하세요:

  • 연결에 사용할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
  • 리소스: 문서 내 시트를 선택합니다.
  • 작업: 행 업데이트를 선택합니다.
  • 문서: 업데이트할 시트가 있는 스프레드시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, URL로를 선택하여 스프레드시트 URL을 입력하거나, ID로를 선택하여 spreadsheetId를 입력합니다.
    • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
  • 시트: 업데이트할 시트를 선택합니다.
    • 목록에서를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, URL로를 선택하여 시트 URL을 입력하거나, ID로를 선택하여 sheetId를 입력하거나, 이름으로를 선택하여 시트 제목을 입력합니다.
    • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
  • 매핑 열 모드:
    • 각 열 수동 매핑: 각 열에 대해 전송할 값을 입력합니다.
    • 자동 매핑: n8n이 Google Sheets의 열과 일치하는 입력 데이터를 자동으로 찾습니다. 이 모드에서는 입력 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 앞에 필드 편집 노드를 사용하여 변경하세요.)
    • 없음: 데이터를 매핑하지 않습니다.

옵션#

  • 셀 형식: 이 옵션을 사용하여 셀의 데이터를 형식화하는 방법을 선택합니다. 자세한 내용은 Google Sheets API | CellFormat을 참조하세요.
    • Google Sheets가 형식화 (기본값): n8n이 Google Sheets의 기본 설정에 따라 셀의 텍스트와 숫자를 형식화합니다.
    • n8n이 형식화: 시트의 새 셀에 n8n이 제공하는 입력 데이터와 동일한 데이터 유형이 사용됩니다.
  • 시트의 데이터 위치: 시트에서 데이터 범위를 지정해야 할 때 이 옵션을 사용합니다.
    • 헤더 행: 열 헤더가 포함된 행 인덱스를 지정합니다.
    • 첫 번째 데이터 행: 실제 데이터가 시작되는 행 인덱스를 지정합니다.

자세한 내용은 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.