Gmail node 메시지 작업 문서
n8n v2.29Message 작업을 사용하여 Gmail에서 메시지를 전송, 답장, 삭제, 읽음/읽지 않음으로 표시, 라벨 추가, 라벨 제거하거나 메시지를 조회 또는 메시지 목록을 가져올 수 있습니다. 이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Message 작업을 사용하여 Gmail에서 메시지를 전송, 답장, 삭제, 읽음/읽지 않음으로 표시, 라벨 추가, 라벨 제거하거나 메시지를 조회 또는 메시지 목록을 가져올 수 있습니다. Gmail node 자체에 대한 자세한 내용은 Gmail node를 참고하세요.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
메시지에 라벨 추가#
이 작업을 사용하여 메시지에 하나 이상의 라벨을 추가합니다.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Add Label을 선택합니다.
- 메시지 ID(Message ID): 라벨을 추가할 메시지의 ID를 입력합니다.
- 라벨 이름 또는 ID(Label Names or IDs): 추가할 라벨 이름을 선택하거나 ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 **자격 증명(Credential)**을 기준으로 채워집니다.
자세한 내용은 Gmail API Method: users.messages.modify 문서를 참고하세요.
메시지 삭제#
이 작업을 사용하여 메시지를 즉시 영구적으로 삭제합니다.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Delete를 선택합니다.
- 메시지 ID(Message ID): 삭제할 메시지의 ID를 입력합니다.
자세한 내용은 Gmail API Method: users.messages.delete 문서를 참고하세요.
메시지 조회#
이 작업을 사용하여 단일 메시지를 조회합니다.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Get을 선택합니다.
- 메시지 ID(Message ID): 가져오려는 메시지의 ID를 입력합니다.
- 단순화(Simplify): 응답을 단순화된 버전(켬)으로 반환할지 원시 데이터(끔)로 반환할지 선택합니다. 기본값은 켬입니다.
- 이는 API 호출의
format을metadata로 설정하는 것과 동일하며, 이는 이메일 메시지 ID, 라벨, 그리고 From, To, CC, BCC, Subject를 포함한 이메일 헤더를 반환합니다.
- 이는 API 호출의
자세한 내용은 Gmail API Method: users.messages.get 문서를 참고하세요.
여러 메시지 가져오기#
이 작업을 사용하여 둘 이상의 메시지를 가져옵니다.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Get Many를 선택합니다.
- 모두 반환(Return All): 노드가 모든 메시지를 반환할지(켬) 아니면 설정된 한도까지만 반환할지(끔) 선택합니다.
- 한도(Limit): 반환할 메시지의 최대 개수를 입력합니다. **모두 반환(Return All)**을 껐을 때만 사용됩니다.
- 단순화(Simplify): 응답을 단순화된 버전(켬)으로 반환할지 원시 데이터(끔)로 반환할지 선택합니다. 기본값은 켬입니다.
- 이는 API 호출의
format을metadata로 설정하는 것과 동일하며, 이는 이메일 메시지 ID, 라벨, 그리고 From, To, CC, BCC, Subject를 포함한 이메일 헤더를 반환합니다.
- 이는 API 호출의
여러 메시지 가져오기 필터#
다음 필터를 사용하여 노드의 동작을 추가로 세부 조정하세요:
- 스팸 및 휴지통 포함(Include Spam and Trash): 노드가 스팸 및 휴지통 폴더의 메시지를 가져올지(켬) 여부(끔)를 선택합니다.
- 라벨 이름 또는 ID(Label Names or IDs): 선택한 라벨이 추가된 메시지만 반환합니다. 적용할 라벨 이름을 선택하거나 ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 **자격 증명(Credential)**을 기준으로 채워집니다.
- 검색(Search): 반환되는 메시지를 필터링하기 위해
from:과 같은 Gmail 검색 세부 필터를 입력합니다. 자세한 내용은 Refine searches in Gmail을 참고하세요. - 읽음 상태(Read Status): 읽지 않음 및 읽은 이메일(Unread and read emails), 읽지 않은 이메일만(Unread emails only)(기본값), 또는 읽은 이메일만(Read emails only) 중에서 선택합니다.
- 수신 이후(Received After): 지정한 날짜 및 시간 이후에 수신된 이메일만 반환합니다. 날짜 선택기를 사용하여 날짜와 시간을 선택하거나, ISO 형식 문자열 또는 밀리초 단위 타임스탬프로 날짜를 설정하는 표현식을 입력합니다. 문자열 형식에 대한 자세한 내용은 ISO 8601을 참고하세요.
- 수신 이전(Received Before): 지정한 날짜 및 시간 이전에 수신된 이메일만 반환합니다. 날짜 선택기를 사용하여 날짜와 시간을 선택하거나, ISO 형식 문자열 또는 밀리초 단위 타임스탬프로 날짜를 설정하는 표현식을 입력합니다. 문자열 형식에 대한 자세한 내용은 ISO 8601을 참고하세요.
- 발신자(Sender): 특정 발신자의 메시지만 반환하려면 이메일 주소나 발신자 이름의 일부를 입력합니다.
자세한 내용은 Gmail API Method: users.messages.list 문서를 참고하세요.
읽음으로 표시#
이 작업을 사용하여 메시지를 읽음으로 표시합니다.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Mark as Read를 선택합니다.
- 메시지 ID(Message ID): 읽음으로 표시하려는 메시지의 ID를 입력합니다.
자세한 내용은 Gmail API Method: users.messages.modify 문서를 참고하세요.
읽지 않음으로 표시#
이 작업을 사용하여 메시지를 읽지 않음으로 표시합니다.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Mark as Unread를 선택합니다.
- 메시지 ID(Message ID): 읽지 않음으로 표시하려는 메시지의 ID를 입력합니다.
자세한 내용은 Gmail API Method: users.messages.modify 문서를 참고하세요.
메시지에서 라벨 제거#
이 작업을 사용하여 메시지에서 하나 이상의 라벨을 제거합니다.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Remove Label을 선택합니다.
- 메시지 ID(Message ID): 라벨을 제거할 메시지의 ID를 입력합니다.
- 라벨 이름 또는 ID(Label Names or IDs): 제거할 라벨 이름을 선택하거나 ID를 지정하는 표현식을 입력합니다. 드롭다운은 선택한 **자격 증명(Credential)**을 기준으로 채워집니다.
자세한 내용은 Gmail API Method: users.messages.modify 문서를 참고하세요.
메시지에 답장#
이 작업을 사용하여 기존 메시지에 대한 답장 메시지를 전송합니다.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Reply를 선택합니다.
- 메시지 ID(Message ID): 답장할 메시지의 ID를 입력합니다.
- **이메일 유형(Email Type)**을 선택합니다. Text 또는 HTML 중에서 선택합니다.
- 메시지(Message): 이메일 메시지 본문을 입력합니다.
답장 옵션#
다음 옵션을 사용하여 노드의 동작을 추가로 세부 조정하세요:
- n8n 어트리뷰션 추가(Append n8n attribution): 기본적으로 노드는 이메일 하단에
This email was sent automatically with n8n이라는 문구를 추가합니다. 이 문구를 제거하려면 이 옵션을 끕니다. - 첨부 파일(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): Message를 선택합니다.
- 작업(Operation): Send를 선택합니다.
- 받는 사람(To): 이메일을 전송할 이메일 주소를 입력합니다.
- 제목(Subject): 제목 줄을 입력합니다.
- **이메일 유형(Email Type)**을 선택합니다. Text 또는 HTML 중에서 선택합니다.
- 메시지(Message): 이메일 메시지 본문을 입력합니다.
전송 옵션#
다음 옵션을 사용하여 노드의 동작을 추가로 세부 조정하세요:
- n8n 어트리뷰션 추가(Append n8n attribution): 기본적으로 노드는 이메일 하단에
This email was sent automatically with n8n이라는 문구를 추가합니다. 이 문구를 제거하려면 이 옵션을 끕니다. - 첨부 파일(Attachments): 첨부 파일을 추가하려면 Add Attachment를 선택합니다. 입력 노드의 어떤 필드에 첨부 파일이 포함되어 있는지 식별하기 위해 **첨부 파일 필드 이름(입력 시)(Attachment Field Name (in Input))**을 입력합니다.
- 여러 속성이 있는 경우 쉼표로 구분된 목록을 입력합니다.
- 참조(BCC): 숨은 참조 수신자의 이메일 주소를 하나 이상 입력합니다. 여러 이메일 주소는 쉼표로 구분합니다(예:
jay@gatsby.com, jon@smith.com). - 참조(CC): 참조 수신자의 이메일 주소를 하나 이상 입력합니다. 여러 이메일 주소는 쉼표로 구분합니다(예:
jay@gatsby.com, jon@smith.com). - 발신자 이름(Sender Name): 수신자의 이메일에 발신자로 표시할 이름을 입력합니다.
- 답장 받을 주소(Send Replies To): 답장을 받을 주소로 설정할 이메일 주소를 입력합니다.
- 발신자에게만 답장(Reply to Sender Only): 전체 답장(끔) 또는 발신자에게만 답장(켬) 중에서 선택합니다.
자세한 내용은 Gmail API Method: users.messages.send 문서를 참고하세요.
메시지 전송 및 승인 대기#
이 작업을 사용하여 메시지를 전송하고, 워크플로 실행을 계속하기 전에 수신자의 승인을 기다립니다.
복잡한 승인에는 Wait 사용
Send and Wait for Approval 작업은 단순한 승인 프로세스에 적합합니다. 더 복잡한 승인의 경우 Wait node 사용을 고려하세요.
다음 매개변수를 입력하세요:
- **연결할 자격 증명(Credential to connect with)**을 선택하거나 새로 생성합니다.
- 리소스(Resource): Message를 선택합니다.
- 작업(Operation): Send and Wait for Approval을 선택합니다.
- 받는 사람(To): 이메일을 전송할 이메일 주소를 입력합니다.
- 제목(Subject): 제목 줄을 입력합니다.
- 메시지(Message): 이메일 메시지 본문을 입력합니다.
승인 대기 옵션#
다음 옵션을 사용하여 노드의 동작을 추가로 세부 조정하세요:
- 승인 유형(Type of Approval): 승인 버튼만 포함하려면 Approve Only(기본값)를, 거부 옵션도 포함하려면 Approve and Disapprove를 선택합니다.
- 승인 버튼 라벨(Approve Button Label): 승인 버튼에 사용할 라벨입니다(기본값은 Approve).
- 승인 버튼 스타일(Approve Button Style): 승인 버튼을 Primary(기본값) 또는 Secondary 버튼으로 스타일링할지 여부입니다.
- 거부 버튼 라벨(Disapprove Button Label): 거부 버튼에 사용할 라벨입니다(기본값은 Decline). **승인 유형(Type of Approval)**을 Approve and Disapprove로 설정한 경우에만 표시됩니다.
- 거부 버튼 스타일(Disapprove Button Style): 거부 버튼을 Primary 또는 Secondary(기본값) 버튼으로 스타일링할지 여부입니다. **승인 유형(Type of Approval)**을 Approve and Disapprove로 설정한 경우에만 표시됩니다.
자세한 내용은 Gmail API Method: users.messages.send 문서를 참고하세요.
일반적인 문제#
일반적인 오류나 문제와 권장 해결 단계는 Common Issues를 참고하세요.