Class MailApp

MailApp

이메일을 전송합니다.

이 서비스를 통해 사용자는 이메일 내용을 완전히 제어하는 이메일을 보낼 수 있습니다. GmailApp과 달리 MailApp의 유일한 목적은 이메일 전송입니다. MailApp에서 사용자의 Gmail에 액세스할 수 없음 받은 편지함에 로그인합니다.

GmailApp을 사용하여 작성된 스크립트를 변경하면 재승인이 트리거될 가능성이 높습니다. 훨씬 더 오래 걸릴 수 있습니다.

메서드

메서드반환 유형간략한 설명
getRemainingDailyQuota()Integer남은 시간 동안 이메일을 보낼 수 있는 수신자 수를 반환합니다.
sendEmail(message)void이메일 메시지를 보냅니다.
sendEmail(recipient, subject, body)void이메일 메시지를 보냅니다.
sendEmail(recipient, subject, body, options)void선택적 인수를 사용하여 이메일 메시지를 보냅니다.
sendEmail(to, replyTo, subject, body)void이메일 메시지를 보냅니다.

자세한 문서

getRemainingDailyQuota()

남은 시간 동안 이메일을 보낼 수 있는 수신자 수를 반환합니다. 반환된 값은 현재 실행에 유효하며 실행 간에 다를 수 있습니다.

할당량은 이메일 수신자 수를 기준으로 합니다. 구체적인 할당량 정보는 Google 할당량과 '서비스'로 이동합니다.

var emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log("Remaining email quota: " + emailQuotaRemaining);

리턴

Integer - 스크립트가 보낼 수 있는 나머지 이메일 수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/script.send_mail

sendEmail(message)

이메일 메시지를 보냅니다. 이 메서드 변형은 훨씬 유연하므로 많은 수의 옵션 더보기

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  var googleLogoUrl = "https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png";
  var youtubeLogoUrl =
        "https://developers.google.com/youtube/images/YouTube_logo_standard_white.png";
  var googleLogoBlob = UrlFetchApp
                         .fetch(googleLogoUrl)
                         .getBlob()
                         .setName("googleLogoBlob");
  var youtubeLogoBlob = UrlFetchApp
                          .fetch(youtubeLogoUrl)
                          .getBlob()
                          .setName("youtubeLogoBlob");
  MailApp.sendEmail({
    to: "recipient@example.com",
    subject: "Logos",
    htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" +
              "inline YouTube Logo <img src='cid:youtubeLogo'>",
    inlineImages:
      {
        googleLogo: googleLogoBlob,
        youtubeLogo: youtubeLogoBlob
      }
  });
}

매개변수

이름유형설명
messageObject이메일 메시지를 나타내는 JavaScript 객체

고급 매개변수

이름유형설명
attachmentsBlobSource[]- 이메일로 보낼 파일의 배열
bccString숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록
bodyString이메일의 본문입니다.
ccString참조로 추가할 이메일 주소의 쉼표로 구분된 목록
htmlBodyString설정된 경우 HTML을 렌더링할 수 있는 기기에서 HTML을 대신 사용합니다. 필수 본문 인수의 값을 반환합니다. HTML에 선택사항인 inlineImages 필드를 추가할 수 있습니다. 이메일에 인라인 이미지가 있는 경우 본문
inlineImagesObject이미지 키의 매핑을 포함하는 JavaScript 객체 (String)를 이미지 데이터 (BlobSource)로 여기서는 htmlBody 매개변수가 사용되었다고 가정합니다. 그리고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다 (예 참조).
nameString이메일 발신자의 이름입니다. 기본값은 발신자의 사용자 이름을 입력하세요.
noReplyBooleantrue 일반 웹 주소로 이메일을 보내야 하는 경우 수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은 Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음
replyToString기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소) noReplytrue로 설정되면 replyTo는 무시됩니다.
subjectString이메일의 제목입니다.
toString수신자의 이메일 주소 또는 쉼표로 구분된 이메일 주소를 수신자로

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/script.send_mail

참고 항목


sendEmail(recipient, subject, body)

이메일 메시지를 보냅니다.

MailApp.sendEmail("recipient@example.com",
                  "TPS reports",
                  "Where are the TPS reports?");

매개변수

이름유형설명
recipientString쉼표로 구분된 수신자 주소
subjectString제목
bodyString이메일의 본문입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/script.send_mail

sendEmail(recipient, subject, body, options)

선택적 인수를 사용하여 이메일 메시지를 보냅니다.

// Send an email with two attachments: a file from Google Drive (as a PDF) and an HTML file.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var blob = Utilities.newBlob('Insert any HTML content here', 'text/html', 'my_document.html');
MailApp.sendEmail('mike@example.com', 'Attachment example', 'Two files are attached.', {
    name: 'Automatic Emailer Script',
    attachments: [file.getAs(MimeType.PDF), blob]
});

매개변수

이름유형설명
recipientString쉼표로 구분된 수신자 주소
subjectString제목
bodyString이메일의 본문입니다.
optionsObject아래 나열된 고급 매개변수를 지정하는 JavaScript 객체

고급 매개변수

이름유형설명
attachmentsBlobSource[]- 이메일로 보낼 파일의 배열 (예시 참조)
bccString숨은참조에 추가할 이메일 주소를 쉼표로 구분한 목록
ccString참조로 추가할 이메일 주소의 쉼표로 구분된 목록
htmlBodyString설정된 경우 HTML을 렌더링할 수 있는 기기에서 HTML을 대신 사용합니다. 필수 본문 인수의 값을 반환합니다. HTML에 선택사항인 inlineImages 필드를 추가할 수 있습니다. 이메일에 인라인 이미지가 있는 경우 본문
inlineImagesObject이미지 키의 매핑을 포함하는 JavaScript 객체 (String)를 이미지 데이터 (BlobSource)로 여기서는 htmlBody 매개변수가 사용된다고 가정하고 <img src="cid:imageKey" /> 형식으로 이러한 이미지에 대한 참조를 포함합니다.
nameString이메일 발신자의 이름 (기본값: 사용자 이름)
noReplyBooleantrue 일반 웹 주소로 이메일을 보내야 하는 경우 수신자가 이메일에 응답하지 못하도록 하는 무응답 이메일 주소 이 옵션은 Google Workspace 계정에서만 지원되며 Gmail 사용자는 사용할 수 없음
replyToString기본 답장 주소로 사용할 이메일 주소 (기본값: 사용자의 이메일 주소)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/script.send_mail

참고 항목


sendEmail(to, replyTo, subject, body)

이메일 메시지를 보냅니다. 이 방법을 사용하면 사용자가 보낸 사람과 다를 수 있는 보낸 메일입니다.

MailApp.sendEmail("recipient@example.com",
                  "replies@example.com",
                  "TPS report status",
                  "What is the status of those TPS reports?");

매개변수

이름유형설명
toString쉼표로 구분된 수신자 주소
replyToString답장받을 주소
subjectString제목
bodyString일반 텍스트로 된 이메일 본문

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/script.send_mail