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

행 추가 또는 업데이트#

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

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

• Credential to connect with: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• Resource: Sheet Within Document를 선택합니다.
• Operation: Append or Update Row를 선택합니다.
• Document: 행을 추가하거나 업데이트하려는 시트가 포함된 스프레드시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, By URL을 선택하여 스프레드시트의 URL을 입력하거나, By ID를 선택하여 spreadsheetId를 입력합니다.
  • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• Sheet: 행을 추가하거나 업데이트하려는 시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, By URL을 선택하여 시트의 URL을 입력하거나, By ID를 선택하여 sheetId를 입력하거나, By Name을 선택하여 시트 제목을 입력합니다.
  • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
• Mapping Column Mode:
  • Map Each Column Manually: 각 열에 대해 Values to Send를 입력합니다.
  • Map Automatically: n8n이 Google Sheets의 열과 일치하는 수신 데이터를 자동으로 찾습니다. 이 모드에서는 수신 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 이전에 Edit Fields 노드를 사용하여 변경할 수 있습니다.)
  • Nothing: 어떤 데이터도 매핑하지 않습니다.

옵션#

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

행 추가#

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

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

• Credential to connect with: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• Resource: Sheet Within Document를 선택합니다.
• Operation: Append Row를 선택합니다.
• Document: 행을 추가하려는 시트가 있는 스프레드시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, By URL을 선택하여 스프레드시트의 URL을 입력하거나, By ID를 선택하여 spreadsheetId를 입력합니다.
  • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• Sheet: 행을 추가하려는 시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, By URL을 선택하여 시트의 URL을 입력하거나, By ID를 선택하여 sheetId를 입력하거나, By Name을 선택하여 시트 제목을 입력합니다.
  • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
• Mapping Column Mode:
  • Map Each Column Manually: 업데이트할 행을 찾을 때 사용할 Column to Match On을 선택합니다. 각 열에 대해 Values to Send를 입력합니다.
  • Map Automatically: n8n이 Google Sheets의 열과 일치하는 수신 데이터를 자동으로 찾습니다. 이 모드에서는 수신 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 이전에 Edit Fields 노드를 사용하여 변경할 수 있습니다.)
  • Nothing: 어떤 데이터도 매핑하지 않습니다.

옵션#

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

시트 지우기#

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

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

• Credential to connect with: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• Resource: Sheet Within Document를 선택합니다.
• Operation: Clear를 선택합니다.
• Document: 데이터를 지우려는 시트가 있는 스프레드시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, By URL을 선택하여 스프레드시트의 URL을 입력하거나, By ID를 선택하여 spreadsheetId를 입력합니다.
  • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• Sheet: 데이터를 지우려는 시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, By URL을 선택하여 시트의 URL을 입력하거나, By ID를 선택하여 sheetId를 입력하거나, By Name을 선택하여 시트 제목을 입력합니다.
  • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
• Clear: 시트에서 지울 데이터를 선택합니다.
  • Whole Sheet: 시트 전체 데이터를 지웁니다. Keep First Row를 켜면 시트의 첫 번째 행을 유지합니다.
  • Specific Rows: 특정 행의 데이터를 지웁니다. 다음도 입력하세요:
    • Start Row Number: 지우려는 첫 번째 행 번호를 입력합니다.
    • Number of Rows to Delete: 지울 행의 수를 입력합니다. 1은 Start Row Number의 행만 지웁니다.
  • Specific Columns: 특정 열의 데이터를 지웁니다. 다음도 입력하세요:
    • Start Column: 문자 표기법을 사용하여 지우려는 첫 번째 열을 입력합니다.
    • Number of Columns to Delete: 지울 열의 수를 입력합니다. 1은 Start Column의 열만 지웁니다.
  • Specific Range: A1 표기법으로 데이터를 지울 테이블 범위를 입력합니다.

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

새 시트 생성#

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

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

• Credential to connect with: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• Resource: Sheet Within Document를 선택합니다.
• Operation: Create를 선택합니다.
• Document: 새 시트를 생성하려는 스프레드시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, By URL을 선택하여 스프레드시트의 URL을 입력하거나, By ID를 선택하여 spreadsheetId를 입력합니다.
  • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• Title: 새 시트의 제목을 입력합니다.

옵션#

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

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

시트 삭제#

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

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

• Credential to connect with: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• Resource: Sheet Within Document를 선택합니다.
• Operation: Delete를 선택합니다.
• Document: 삭제하려는 시트가 포함된 스프레드시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, By URL을 선택하여 스프레드시트의 URL을 입력하거나, By ID를 선택하여 spreadsheetId를 입력합니다.
  • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• Sheet: 삭제하려는 시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, By URL을 선택하여 시트의 URL을 입력하거나, By ID를 선택하여 sheetId를 입력하거나, By Name을 선택하여 시트 이름을 입력합니다.
  • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.

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

행 또는 열 삭제#

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

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

• Credential to connect with: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• Resource: Sheet Within Document를 선택합니다.
• Operation: Delete Rows or Columns를 선택합니다.
• Document: 행 또는 열을 삭제하려는 시트가 포함된 스프레드시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, By URL을 선택하여 스프레드시트의 URL을 입력하거나, By ID를 선택하여 spreadsheetId를 입력합니다.
  • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• Sheet: 행 또는 열을 삭제하려는 시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, By URL을 선택하여 시트의 URL을 입력하거나, By ID를 선택하여 sheetId를 입력하거나, By Name을 선택하여 시트 이름을 입력합니다.
  • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
• Start Row Number 또는 Start Column: 삭제를 시작할 행 번호 또는 열 문자를 입력합니다.
• Number of Rows to Delete 또는 Number of Columns to delete: 삭제할 행 또는 열의 수를 입력합니다.

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

행 가져오기#

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

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

• Credential to connect with: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• Resource: Sheet Within Document를 선택합니다.
• Operation: **Get Row(s)**를 선택합니다.
• Document: 행을 가져오려는 시트가 포함된 스프레드시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, By URL을 선택하여 스프레드시트의 URL을 입력하거나, By ID를 선택하여 spreadsheetId를 입력합니다.
  • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• Sheet: 행을 읽으려는 시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, By URL을 선택하여 시트의 URL을 입력하거나, By ID를 선택하여 sheetId를 입력하거나, By Name을 선택하여 시트 이름을 입력합니다.
  • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
• Filters: 기본적으로 노드는 시트의 모든 행을 반환합니다. 제한된 결과 집합을 반환하려면 필터를 설정하세요:
  • Column: 검색할 시트의 열을 선택합니다.
  • Value: 검색할 셀 값을 입력합니다. 여기에 입력 데이터 매개변수를 드래그할 수 있습니다. 필터가 여러 행과 일치하는 경우 n8n은 첫 번째 결과를 반환합니다. 일치하는 모든 행을 원하는 경우:
    1. Options에서 Add Option > When Filter Has Multiple Matches를 선택합니다.
    2. When Filter Has Multiple Matches를 Return All Matches로 변경합니다.

옵션#

• Data Location on Sheet: 이 옵션을 사용하여 데이터 범위를 지정합니다. 기본적으로 n8n은 시트의 마지막 행까지 범위를 자동으로 감지합니다.
• Output Formatting: 이 옵션을 사용하여 Google Sheets가 반환하는 데이터를 n8n이 형식화하는 방식을 선택합니다.
  • General Formatting:
    • Values (unformatted) (기본값): n8n이 통화 기호 및 기타 특수 서식을 제거합니다. 데이터 유형은 숫자로 유지됩니다.
    • Values (formatted): n8n이 데이터 유형을 숫자에서 문자열로 변환하여 Google Sheets에 표시되는 대로 값을 표시합니다(예: 쉼표나 통화 기호 유지).
    • Formulas: n8n이 수식을 반환합니다. 수식 결과를 계산하지 않습니다. 예를 들어 셀 B2에 =A2 수식이 있으면 n8n은 B2의 값을 =A2(텍스트)로 반환합니다. 자세한 내용은 About date & time values | Google Sheets를 참고하세요.
  • Date Formatting: 자세한 내용은 DateTimeRenderOption | Google Sheets를 참고하세요.
    • Formatted Text (기본값): 스프레드시트 로케일에 따라 Google Sheets에 표시되는 대로 표시합니다. 예: 01/01/2024.
    • Serial Number: 1899년 12월 30일 이후 경과 일수입니다.
  • When Filter Has Multiple Matches: 여러 일치 항목을 가져오려면 Return All Matches로 설정합니다. 기본적으로 첫 번째 결과만 반환됩니다.

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

행 업데이트#

이 작업을 사용하여 시트의 기존 행을 업데이트합니다. 이 작업은 기존 행만 업데이트합니다. 시트에서 일치하는 항목을 찾지 못한 경우 행을 추가하려면 대신 Append or Update Row 작업을 사용하세요.

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

• Credential to connect with: 기존 Google Sheets 자격 증명을 생성하거나 선택합니다.
• Resource: Sheet Within Document를 선택합니다.
• Operation: Update Row를 선택합니다.
• Document: 업데이트하려는 시트가 있는 스프레드시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 스프레드시트 제목을 선택하거나, By URL을 선택하여 스프레드시트의 URL을 입력하거나, By ID를 선택하여 spreadsheetId를 입력합니다.
  • spreadsheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• Sheet: 업데이트하려는 시트를 선택합니다.
  • From list를 선택하여 드롭다운 목록에서 시트 제목을 선택하거나, By URL을 선택하여 시트의 URL을 입력하거나, By ID를 선택하여 sheetId를 입력하거나, By Name을 선택하여 시트 제목을 입력합니다.
  • sheetId는 Google Sheets URL에서 확인할 수 있습니다: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
• Mapping Column Mode:
  • Map Each Column Manually: 각 열에 대해 Values to Send를 입력합니다.
  • Map Automatically: n8n이 Google Sheets의 열과 일치하는 수신 데이터를 자동으로 찾습니다. 이 모드에서는 수신 데이터 필드가 Google Sheets의 열과 동일한지 확인하세요. (필요한 경우 이 노드 이전에 Edit Fields 노드를 사용하여 변경할 수 있습니다.)
  • Nothing: 어떤 데이터도 매핑하지 않습니다.

옵션#

• 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: 실제 데이터가 시작되는 행 인덱스를 지정합니다.

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