Google Sheets 문서 내 시트 작업

이 작업을 사용하여 Google Sheets에서 Google 스프레드시트의 시트를 생성, 업데이트, 삭제 또는 지울 수 있습니다. Google Sheets 노드에 대한 자세한 내용은 Google Sheets를 참조하십시오.

행 추가 또는 업데이트

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

다음 매개변수를 입력하십시오:

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

옵션

• 셀 형식(Cell Format): 셀의 데이터를 어떻게 형식화할지 선택하는 옵션입니다. 자세한 내용은 Google Sheets API | CellFormat 문서를 참고하세요.

  • Google Sheets에서 자동 형식 지정 (기본값): n8n이 Google Sheets의 기본 설정에 따라 셀의 텍스트 및 숫자를 형식화합니다.
  • n8n에서 직접 형식 지정: 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): 오류를 발생시키고 실행을 중단합니다.

• 추가(Append) 사용: 새로운 데이터 행을 추가할 때 Google API Append 엔드포인트를 사용할 수 있도록 활성화하는 옵션입니다.

  • 기본적으로 n8n은 빈 행이나 열을 추가한 후 새로운 데이터를 삽입합니다. 이 방식은 데이터 정렬을 보장할 수 있지만, 비효율적일 수 있습니다. Append 엔드포인트를 사용하면 API 호출 횟수를 최소화하고 프로세스를 단순화하여 성능을 향상시킬 수 있습니다. 그러나 기존 시트 데이터에 행과 열 사이에 빈 공간이 있거나 불규칙한 경우, 새로운 데이터가 잘못된 위치에 삽입되어 정렬이 어긋날 수 있습니다.
  • 성능이 중요한 경우, 그리고 시트 내 데이터 구조가 빈 공간 없이 일정하게 유지되는 경우 이 옵션을 사용하는 것이 좋습니다.

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

행 추가

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

다음 매개변수를 입력하십시오:

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

옵션

• 셀 형식(Cell Format): 셀의 데이터를 어떻게 형식화할지 선택하는 옵션입니다. 자세한 내용은 Google Sheets API | CellFormat 문서를 참고하세요.

  • Google Sheets에서 자동 형식 지정 (기본값): n8n이 Google Sheets의 기본 설정에 따라 셀의 텍스트 및 숫자를 형식화합니다.
  • n8n에서 직접 형식 지정: 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): 오류를 발생시키고 실행을 중단합니다.

• 추가(Append) 사용: 새로운 데이터 행을 추가할 때 Google API Append 엔드포인트를 사용할 수 있도록 활성화하는 옵션입니다.

  • 기본적으로 n8n은 빈 행이나 열을 추가한 후 새로운 데이터를 삽입합니다. 이 방식은 데이터 정렬을 보장할 수 있지만, 비효율적일 수 있습니다. Append 엔드포인트를 사용하면 API 호출 횟수를 최소화하고 프로세스를 단순화하여 성능을 향상시킬 수 있습니다. 그러나 기존 시트 데이터에 행과 열 사이에 빈 공간이 있거나 불규칙한 경우, 새로운 데이터가 잘못된 위치에 삽입되어 정렬이 어긋날 수 있습니다.
  • 성능이 중요한 경우, 그리고 시트 내 데이터 구조가 빈 공간 없이 일정하게 유지되는 경우 이 옵션을 사용하는 것이 좋습니다.

자세한 정보는 Method: spreadsheets.values.append | Google Sheets API 문서를 참조하세요.

시트 지우기

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

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

• 연결할 자격 증명: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• 리소스: 문서 내 시트를 선택합니다.
• 작업: 지우기를 선택합니다.
• 문서: 데이터를 지우고자 하는 시트가 있는 스프레드시트를 선택합니다.
  • 드롭다운 목록에서 스프레드시트 제목을 선택하려면 목록에서 선택을, 스프레드시트의 URL을 입력하려면 URL로를, spreadsheetId를 입력하려면 ID로를 선택합니다.
  • spreadsheetId는 Google Sheets URL에서 찾을 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• 시트: 데이터를 지우고자 하는 시트를 선택합니다.
  • 드롭다운 목록에서 시트 제목을 선택하려면 목록에서 선택을, 시트의 URL을 입력하려면 URL로를, sheetId를 입력하려면 ID로를, 시트 제목을 입력하려면 이름으로를 선택합니다.
  • 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로를, spreadsheetId를 입력하려면 ID로를 선택합니다.
  • spreadsheetId는 Google Sheets URL에서 찾을 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• 제목: 새 시트의 제목을 입력합니다.

옵션

• 숨기기: 이 옵션을 켜면 UI에서 시트가 숨겨집니다.
• 오른쪽에서 왼쪽으로: 이 옵션을 켜면 LTR 시트 대신 RTL 시트를 사용합니다.
• 시트 ID: 시트의 ID를 입력합니다.
  • Google Sheets URL에서 sheetId를 찾을 수 있습니다: 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로를, spreadsheetId를 입력하기 위해 ID로를 선택합니다.
  • Google Sheets URL에서 spreadsheetId를 찾을 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• 시트: 삭제할 시트를 선택합니다.
  • 드롭다운 목록에서 시트 제목을 선택하기 위해 목록에서 선택을, 시트의 URL을 입력하기 위해 URL로를, sheetId를 입력하기 위해 ID로를, 시트의 이름을 입력하기 위해 이름으로를 선택합니다.
  • Google Sheets URL에서 sheetId를 찾을 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.

더 많은 정보는 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 또는 열 삭제

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

다음 매개변수를 입력합니다:

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

더 많은 정보는 Method: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 가져오기

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

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

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

옵션

• 시트의 데이터 위치: 이 옵션을 사용하여 데이터 범위를 지정합니다. 기본적으로 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의 첫 번째 행을 헤더 행으로 처리하며 모든 행을 읽을 때 반환하지 않습니다. 첫 번째 행을 읽으려면 옵션을 사용하여 시트의 데이터 위치를 설정하세요.

추가 정보는 방법: spreadsheets.batchUpdate | Google Sheets API 문서를 참조하세요.

행 업데이트

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

이 매개변수를 입력하십시오:

• 연결할 인증 정보: 기존의 Google Sheets 인증 정보를 생성하거나 선택합니다.
• 리소스: 문서 내 시트를 선택합니다.
• 작업: 행 업데이트를 선택합니다.
• 문서: 업데이트할 시트를 포함하는 스프레드시트를 선택합니다.
  • 드롭다운 목록에서 스프레드시트 제목을 선택하려면 목록에서 선택을, 스프레드시트의 URL을 입력하려면 URL로를, spreadsheetId를 입력하려면 ID로를 선택합니다.
  • Google Sheets URL에서 spreadsheetId를 찾을 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• 시트: 업데이트할 시트를 선택합니다.
  • 드롭다운 목록에서 시트 제목을 선택하려면 목록에서 선택을, 시트의 URL을 입력하려면 URL로를, sheetId를 입력하려면 ID로를, 시트 제목을 입력하려면 이름으로를 선택합니다.
  • Google Sheets URL에서 sheetId를 찾을 수 있습니다: 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 문서를 참조하십시오.