메일 API 개요

App Engine 애플리케이션은 앱의 이메일 수신 주소를 대신하거나 Google 계정을 보유한 사용자를 대신하여 이메일 메시지를 보낼 수 있습니다. 앱은 다양한 주소로 이메일을 수신할 수 있습니다. 앱은 메일 서비스를 사용하여 메시지를 보내고, App Engine이 생성하여 앱에 게시하는 HTTP 요청의 형태로 메시지를 수신합니다.

메일 보내기

메일 서비스는 한 명 이상의 수신자에게 이메일 메시지를 보낼 수 있습니다. 메시지에는 제목, 일반 텍스트 본문, 선택 사항인 HTML 본문이 포함됩니다. 또한 첨부파일과 제한된 헤더 집합이 포함될 수 있습니다.

수신자로 가능한 이메일 주소에는 제한이 없습니다. 수신자는 메시지의 '받는사람' 필드 또는 '참조' 필드에 포함되거나 메시지의 수신자가 알 수 없도록 '숨은참조' 필드에 포함될 수 있습니다.

애플리케이션이 메일 서비스를 호출하여 메시지를 보내면 메시지가 대기열에 추가되고 호출은 즉시 반환됩니다. 메일 서비스는 표준 절차에 따라 각 수신자의 메일 서버에 연결하여 메시지를 전달하고, 메일 서버에 연결할 수 없는 경우 다시 시도합니다.

메일을 보낼 수 있는 사람

보안을 위해 메시지의 발신자 주소는 다음 중 하나로 제한됩니다.

  • 현재 로그인한 사용자의 Gmail 또는 G Suite 계정
  • anything@[MY_PROJECT_ID].appspotmail.com 또는 anything@[MY_PROJECT_NUMBER].appspotmail.com 형식의 이메일 주소
  • GCP Console에서 이메일 API 승인된 발신자에 나열된 모든 이메일 주소

이메일 API 승인된 발신자 목록의 모든 이메일 주소는 유효한 Gmail 계정 또는 Google이 호스팅하는 도메인 계정이어야 합니다. 앱 관리자가 승인된 발신자 목록에 추가할 수 있는 계정은 다음과 같습니다.

  • 자신의 이메일 주소
  • 자신이 소유자 또는 관리자인 그룹
  • 애플리케이션이 G Suite 도메인에 호스팅된 경우(noreply@[DOMAIN].com). 단, noreply@[DOMAIN].com은 유효한 계정(사용자 또는 그룹)이어야 함

또한 G Suite가 관리하는 도메인의 도메인 관리자는 자신의 도메인에 속한 모든 사용자를 승인된 발신자 목록에 추가할 수 있습니다.

승인된 발신자 수는 최대 50명으로 제한됩니다.

G Suite에서 보내는 메일

G Suite가 관리하는 도메인에서 이메일을 보내는 경우, 도메인의 DNS SPF 레코드를 설정하여 Google이 이메일의 신뢰할 수 있는 출처임을 알려야 합니다. 이렇게 하는 방법은 G Suite 도움말에서 SPF 레코드를 참조하세요.

G Suite 도메인에 설정된 별칭을 사용하는 경우 도메인 별칭을 사용하는 이메일 주소에서는 이메일을 보낼 수 없습니다.

메일 미도착 시 반송 알림

메일이 스팸, 바이러스, 기타 악성 콘텐츠의 알려진 서명과 일치하는 경우 전송이 수락되지 않을 수 있습니다.

메일 서비스에서 메시지를 전송할 수 없거나 수신자의 메일 서버에서 반송 메시지를 반환한 경우(예: 해당 시스템에 해당 주소를 갖는 계정이 없는 경우) 메시지 발신자의 이메일 주소로 오류 메시지가 전송될 수 있습니다. 애플리케이션 자체는 전송 성공 또는 실패 여부에 대해 어떠한 알림도 받지 않습니다.

이메일 반송 알림은 기본적으로 사용 설정되지 않습니다. 이메일 반송 알림을 받으려면 애플리케이션을 구성해야 합니다. 자세한 내용은 반송 알림 수신을 참조하세요.

메일 및 개발 서버

개발 서버에서 실행 중인 애플리케이션이 메일 서비스를 호출하여 이메일 메시지를 보내면 메시지가 애플리케이션 로그에 출력됩니다. 개발 서버는 이메일 메시지를 보내지 않습니다.

도메인 키 확인 메일(DKIM)을 통한 인증

메일을 보내면 App Engine은 도메인 키 확인 메일(DKIM) 표준을 사용하여 도메인을 인증합니다. 애플리케이션에서 G Suite 도메인에 속하는 이메일 주소로부터 메시지를 보내는 경우 App Engine이 해당 이메일을 암호화 서명할 수 있습니다. 이 서명은 emma@example.com에서 보낸 것으로 표시된 이메일을 실제로 example.com에서 보냈음을 증명합니다. 수신자는 이 서명을 확인할 수 있습니다. 서명이 올바르다면 발신자의 도메인이 위장되지 않았음을 알게 됩니다.

G Suite 이메일 주소로부터 보내는 메시지에 DKIM 인증을 사용 설정하려면 G Suite 고객센터의 안내를 따르세요. G Suite 도메인에서 DKIM 인증이 활성화되기까지 최대 48시간이 걸릴 수 있습니다.

또한 애플리케이션이 커스텀 도메인을 사용하며 G Suite 도메인과 동일한지 확인해야 합니다. 단, subdomain.example.com과 같은 하위 도메인을 갖는 G Suite 도메인은 허용되지 않습니다.

발신자 주소가 DKIM이 사용 설정된 G Suite 도메인에 속하는 경우 App Engine은 애플리케이션의 발신 이메일에 서명합니다. 또한 이메일 주소의 도메인 부분이 소문자로만 구성되도록 발신자 주소의 형식을 지정해야 합니다.

할당량 및 한도

애플리케이션이 현재 사용 중인 할당량을 보려면 Google Cloud Platform 콘솔의 할당량 세부정보 페이지로 이동합니다.

할당량 세부정보 페이지로 이동

각 메일 서비스 요청은 Mail API 호출 할당량에 반영됩니다. 보낼 수 있는 메시지 수, 보낼 수 있는 관리자 메시지 수, 보낼 수 있는 데이터와 첨부파일 양에 대한 할당량도 있습니다. 자세한 내용은 메일 할당량을 참조하세요.

할당량은 매일 재설정됩니다. 일일 할당량을 초과하면 할당량 초과 예외가 발생합니다. 할당량을 초과하여 메일을 보내야 하는 경우에는 SendGrid 또는 Mailgun과 같은 타사 메일 공급자를 사용하면 됩니다.

메일 서비스에는 할당량 이외에도 다음과 같은 한도가 적용됩니다.

한도 용량
발신 메일 메시지 최대 크기(첨부파일 포함) 31.5MB
수신 메일 메시지 최대 크기(첨부파일 포함) 31.5MB
수신자가 관리자인 경우의 최대 메시지 크기 16KB
승인된 최대 발신자 수 50

다음 단계

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

자바용 App Engine 표준 환경