Gmail 노드 Thread 작업 문서

요약

Thread 작업을 사용하여 스레드를 삭제, 답장, 휴지통 이동, 휴지통에서 복원, 라벨 추가/제거, 단일 조회 또는 목록 조회할 수 있습니다. 이 작업을 사용하여 새 초안을 생성합니다. 자세한 내용은 Gmail API Method: users.threads.modify 문서를 참고하세요.

Thread 작업을 사용하여 스레드를 삭제, 답장, 휴지통 이동, 휴지통에서 복원, 라벨 추가/제거, 단일 조회 또는 목록 조회할 수 있습니다. Gmail 노드 자체에 대한 자세한 내용은 Gmail 노드를 참고하세요.

스레드에 라벨 추가#

이 작업을 사용하여 새 초안을 생성합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Add Label을 선택합니다.
Thread ID: 라벨을 추가하려는 스레드의 ID를 입력합니다.
Label Names or IDs: 적용하려는 라벨 이름을 선택하거나, ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 Credential을 기준으로 채워집니다.

자세한 내용은 Gmail API Method: users.threads.modify 문서를 참고하세요.

스레드 삭제#

이 작업을 사용하여 스레드와 그 안의 모든 메시지를 즉시 영구적으로 삭제합니다.

Note

영구 삭제

이 작업은 취소할 수 없습니다. 복구 가능한 삭제가 필요하다면 대신 Trash 작업을 사용하세요.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Delete를 선택합니다.
Thread ID: 삭제하려는 스레드의 ID를 입력합니다.

자세한 내용은 Gmail API Method: users.threads.delete 문서를 참고하세요.

스레드 조회#

이 작업을 사용하여 단일 스레드를 조회합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Get을 선택합니다.
Thread ID: 조회하려는 스레드의 ID를 입력합니다.
Simplify: 응답의 단순화된 버전을 반환할지(켬), 원시 데이터를 반환할지(끔) 선택합니다. 기본값은 켬입니다.
- 이는 API 호출의 format을 metadata로 설정하는 것과 동일하며, 이메일 메시지 ID, 라벨, From, To, CC, BCC, Subject를 포함한 이메일 헤더를 반환합니다.

Get thread 옵션#

다음 옵션을 사용하여 노드의 동작을 더 세부적으로 조정할 수 있습니다.

Return Only Messages: 스레드 메시지만 반환할지(켬) 선택합니다.

자세한 내용은 Gmail API Method: users.threads.get 문서를 참고하세요.

여러 스레드 조회#

이 작업을 사용하여 두 개 이상의 스레드를 조회합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Get Many를 선택합니다.
Return All: 노드가 모든 스레드를 반환할지(켬), 설정된 제한까지만 반환할지(끔) 선택합니다.
Limit: 반환할 스레드의 최대 개수를 입력합니다. Return All을 껐을 때만 사용됩니다.

여러 스레드 조회 필터#

다음 필터를 사용하여 노드의 동작을 더 세부적으로 조정할 수 있습니다.

Include Spam and Trash: 노드가 스팸 및 휴지통 폴더의 스레드를 가져올지(켬) 아닐지(끔) 선택합니다.
Label Names or IDs: 선택한 라벨이 추가된 스레드만 반환합니다. 적용하려는 라벨 이름을 선택하거나, ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 Credential을 기준으로 채워집니다.
Search: 반환되는 스레드를 필터링하기 위해 from: 같은 Gmail 검색 세부 필터를 입력합니다. 자세한 내용은 Gmail에서 검색 세부화하기를 참고하세요.
Read Status: Unread and read emails, Unread emails only(기본값), Read emails only 중에서 수신할 항목을 선택합니다.
Received After: 지정한 날짜 및 시간 이후에 수신된 이메일만 반환합니다. 날짜 선택기를 사용하여 날짜와 시간을 선택하거나, ISO 형식의 문자열 또는 밀리초 단위 타임스탬프로 날짜를 설정하는 표현식을 입력합니다. 문자열 형식에 대한 자세한 내용은 ISO 8601을 참고하세요.
Received Before: 지정한 날짜 및 시간 이전에 수신된 이메일만 반환합니다. 날짜 선택기를 사용하여 날짜와 시간을 선택하거나, ISO 형식의 문자열 또는 밀리초 단위 타임스탬프로 날짜를 설정하는 표현식을 입력합니다. 문자열 형식에 대한 자세한 내용은 ISO 8601을 참고하세요.

자세한 내용은 Gmail API Method: users.threads.list 문서를 참고하세요.

스레드에서 라벨 제거#

이 작업을 사용하여 스레드에서 라벨을 제거합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Remove Label을 선택합니다.
Thread ID: 라벨을 제거하려는 스레드의 ID를 입력합니다.
Label Names or IDs: 제거하려는 라벨 이름을 선택하거나, ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 Credential을 기준으로 채워집니다.

자세한 내용은 Gmail API Method: users.threads.modify 문서를 참고하세요.

메시지에 답장#

이 작업을 사용하여 메시지에 답장합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Reply를 선택합니다.
Thread ID: 답장하려는 스레드의 ID를 입력합니다.
Message Snippet or ID: 답장하려는 메시지를 선택하거나, ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 Credential을 기준으로 채워집니다.
Email Type을 선택합니다. Text 또는 HTML 중에서 선택합니다.
Message: 이메일 메시지 본문을 입력합니다.

Reply 옵션#

다음 옵션을 사용하여 노드의 동작을 더 세부적으로 조정할 수 있습니다.

Attachments: 첨부 파일을 추가하려면 Add Attachment를 선택합니다. 입력 노드의 어떤 필드에 첨부 파일이 포함되어 있는지 지정하려면 **Attachment Field Name (in Input)**을 입력합니다.
- 여러 속성을 지정하려면 쉼표로 구분된 목록을 입력합니다.
BCC: 숨은 참조 수신자의 이메일 주소를 하나 이상 입력합니다. 여러 이메일 주소는 쉼표로 구분합니다. 예: jay@gatsby.com, jon@smith.com.
CC: 참조 수신자의 이메일 주소를 하나 이상 입력합니다. 여러 이메일 주소는 쉼표로 구분합니다. 예: jay@gatsby.com, jon@smith.com.
Sender Name: 수신자의 이메일에 발신자로 표시할 이름을 입력합니다.
Reply to Sender Only: 전체 답장을 할지(끔) 발신자에게만 답장할지(켬) 선택합니다.

자세한 내용은 Gmail API Method: users.messages.send 문서를 참고하세요.

스레드를 휴지통으로 이동#

이 작업을 사용하여 스레드와 그 안의 모든 메시지를 휴지통으로 이동합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Trash를 선택합니다.
Thread ID: 휴지통으로 이동하려는 스레드의 ID를 입력합니다.

자세한 내용은 Gmail API Method: users.threads.trash 문서를 참고하세요.

스레드를 휴지통에서 복원#

이 작업을 사용하여 스레드와 그 안의 모든 메시지를 휴지통에서 복원합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Untrash를 선택합니다.
Thread ID: 휴지통으로 이동하려는 스레드의 ID를 입력합니다.

자세한 내용은 Gmail API Method: users.threads.untrash 문서를 참고하세요.

일반적인 문제#

일반적인 오류나 문제와 권장 해결 방법은 일반적인 문제를 참고하세요.

Gmail 노드 Thread 작업 문서

n8n v2.29

원문 보기

번역일: 2026-06-22

요약

스레드에 라벨 추가#

이 작업을 사용하여 새 초안을 생성합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Add Label을 선택합니다.
Thread ID: 라벨을 추가하려는 스레드의 ID를 입력합니다.
Label Names or IDs: 적용하려는 라벨 이름을 선택하거나, ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 Credential을 기준으로 채워집니다.

자세한 내용은 Gmail API Method: users.threads.modify 문서를 참고하세요.

스레드 삭제#

이 작업을 사용하여 스레드와 그 안의 모든 메시지를 즉시 영구적으로 삭제합니다.

Note

영구 삭제

이 작업은 취소할 수 없습니다. 복구 가능한 삭제가 필요하다면 대신 Trash 작업을 사용하세요.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Delete를 선택합니다.
Thread ID: 삭제하려는 스레드의 ID를 입력합니다.

자세한 내용은 Gmail API Method: users.threads.delete 문서를 참고하세요.

스레드 조회#

이 작업을 사용하여 단일 스레드를 조회합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Get을 선택합니다.
Thread ID: 조회하려는 스레드의 ID를 입력합니다.
Simplify: 응답의 단순화된 버전을 반환할지(켬), 원시 데이터를 반환할지(끔) 선택합니다. 기본값은 켬입니다.
- 이는 API 호출의 format을 metadata로 설정하는 것과 동일하며, 이메일 메시지 ID, 라벨, From, To, CC, BCC, Subject를 포함한 이메일 헤더를 반환합니다.

Get thread 옵션#

다음 옵션을 사용하여 노드의 동작을 더 세부적으로 조정할 수 있습니다.

Return Only Messages: 스레드 메시지만 반환할지(켬) 선택합니다.

자세한 내용은 Gmail API Method: users.threads.get 문서를 참고하세요.

여러 스레드 조회#

이 작업을 사용하여 두 개 이상의 스레드를 조회합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Get Many를 선택합니다.
Return All: 노드가 모든 스레드를 반환할지(켬), 설정된 제한까지만 반환할지(끔) 선택합니다.
Limit: 반환할 스레드의 최대 개수를 입력합니다. Return All을 껐을 때만 사용됩니다.

여러 스레드 조회 필터#

다음 필터를 사용하여 노드의 동작을 더 세부적으로 조정할 수 있습니다.

Include Spam and Trash: 노드가 스팸 및 휴지통 폴더의 스레드를 가져올지(켬) 아닐지(끔) 선택합니다.
Label Names or IDs: 선택한 라벨이 추가된 스레드만 반환합니다. 적용하려는 라벨 이름을 선택하거나, ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 Credential을 기준으로 채워집니다.
Search: 반환되는 스레드를 필터링하기 위해 from: 같은 Gmail 검색 세부 필터를 입력합니다. 자세한 내용은 Gmail에서 검색 세부화하기를 참고하세요.
Read Status: Unread and read emails, Unread emails only(기본값), Read emails only 중에서 수신할 항목을 선택합니다.
Received After: 지정한 날짜 및 시간 이후에 수신된 이메일만 반환합니다. 날짜 선택기를 사용하여 날짜와 시간을 선택하거나, ISO 형식의 문자열 또는 밀리초 단위 타임스탬프로 날짜를 설정하는 표현식을 입력합니다. 문자열 형식에 대한 자세한 내용은 ISO 8601을 참고하세요.
Received Before: 지정한 날짜 및 시간 이전에 수신된 이메일만 반환합니다. 날짜 선택기를 사용하여 날짜와 시간을 선택하거나, ISO 형식의 문자열 또는 밀리초 단위 타임스탬프로 날짜를 설정하는 표현식을 입력합니다. 문자열 형식에 대한 자세한 내용은 ISO 8601을 참고하세요.

자세한 내용은 Gmail API Method: users.threads.list 문서를 참고하세요.

스레드에서 라벨 제거#

이 작업을 사용하여 스레드에서 라벨을 제거합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Remove Label을 선택합니다.
Thread ID: 라벨을 제거하려는 스레드의 ID를 입력합니다.
Label Names or IDs: 제거하려는 라벨 이름을 선택하거나, ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 Credential을 기준으로 채워집니다.

자세한 내용은 Gmail API Method: users.threads.modify 문서를 참고하세요.

메시지에 답장#

이 작업을 사용하여 메시지에 답장합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Reply를 선택합니다.
Thread ID: 답장하려는 스레드의 ID를 입력합니다.
Message Snippet or ID: 답장하려는 메시지를 선택하거나, ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 Credential을 기준으로 채워집니다.
Email Type을 선택합니다. Text 또는 HTML 중에서 선택합니다.
Message: 이메일 메시지 본문을 입력합니다.

Reply 옵션#

다음 옵션을 사용하여 노드의 동작을 더 세부적으로 조정할 수 있습니다.

Attachments: 첨부 파일을 추가하려면 Add Attachment를 선택합니다. 입력 노드의 어떤 필드에 첨부 파일이 포함되어 있는지 지정하려면 **Attachment Field Name (in Input)**을 입력합니다.
- 여러 속성을 지정하려면 쉼표로 구분된 목록을 입력합니다.
BCC: 숨은 참조 수신자의 이메일 주소를 하나 이상 입력합니다. 여러 이메일 주소는 쉼표로 구분합니다. 예: jay@gatsby.com, jon@smith.com.
CC: 참조 수신자의 이메일 주소를 하나 이상 입력합니다. 여러 이메일 주소는 쉼표로 구분합니다. 예: jay@gatsby.com, jon@smith.com.
Sender Name: 수신자의 이메일에 발신자로 표시할 이름을 입력합니다.
Reply to Sender Only: 전체 답장을 할지(끔) 발신자에게만 답장할지(켬) 선택합니다.

자세한 내용은 Gmail API Method: users.messages.send 문서를 참고하세요.

스레드를 휴지통으로 이동#

이 작업을 사용하여 스레드와 그 안의 모든 메시지를 휴지통으로 이동합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Trash를 선택합니다.
Thread ID: 휴지통으로 이동하려는 스레드의 ID를 입력합니다.

자세한 내용은 Gmail API Method: users.threads.trash 문서를 참고하세요.

스레드를 휴지통에서 복원#

이 작업을 사용하여 스레드와 그 안의 모든 메시지를 휴지통에서 복원합니다.

다음 파라미터를 입력하세요.

**연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
Resource: Thread를 선택합니다.
Operation: Untrash를 선택합니다.
Thread ID: 휴지통으로 이동하려는 스레드의 ID를 입력합니다.

자세한 내용은 Gmail API Method: users.threads.untrash 문서를 참고하세요.

일반적인 문제#

일반적인 오류나 문제와 권장 해결 방법은 일반적인 문제를 참고하세요.