이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class MailApp

이메일 전송

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

GmailApp을 사용하여 작성된 스크립트를 변경하면 MailApp 스크립트보다 사용자의 재승인 요청이 트리거될 가능성이 높습니다.

방법

메서드	반환 유형	간략한 설명
`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
      }
  });
}

매개변수

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

고급 매개변수

이름	유형	설명
`attachments`	`BlobSource[]`	이메일과 함께 보낼 파일의 배열
`bcc`	`String`	숨은참조에 쉼표로 구분된 이메일 주소 목록
`body`	`String`	이메일 본문
`cc`	`String`	참조에 넣을 이메일 주소 쉼표로 구분된 목록
`htmlBody`	`String`	이 속성을 설정하면 HTML을 렌더링할 수 있는 기기에서 필수 본문 인수 대신 이 인수를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 `inlineImages` 필드(선택사항)를 추가할 수 있습니다.
`inlineImages`	`Object`	이미지 키(`String`)에서 이미지 데이터 (`BlobSource`)로의 매핑이 포함된 JavaScript 객체입니다. `htmlBody` 매개변수가 사용되고 `<img src="cid:imageKey" />` 형식의 이미지 참조가 포함되어 있다고 가정합니다 (예 참조).
`name`	`String`	이메일을 보낸 사람의 이름입니다. 기본값은 발신자의 사용자 이름입니다.
`noReply`	`Boolean`	수신자가 이메일에 응답하지 못하도록 일반 회신 없는 이메일 주소에서 이메일을 보내야 하는 경우 `true`. 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 사용할 수 있습니다.
`replyTo`	`String`	기본 답장 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소) `noReply`이 `true`로 설정되면 `replyTo`는 무시됩니다.
`subject`	`String`	이메일 제목
`to`	`String`	수신자의 이메일 주소 또는 수신자가 될 쉼표로 구분된 이메일 주소 목록

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

참고 항목

sendEmail(recipient, subject, body, options)

`sendEmail(recipient, subject, body)`

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

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

매개변수

이름	유형	설명
`recipient`	`String`	쉼표로 구분된 수신자 주소
`subject`	`String`	제목
`body`	`String`	이메일 본문

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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]
});

매개변수

이름	유형	설명
`recipient`	`String`	쉼표로 구분된 수신자 주소
`subject`	`String`	제목
`body`	`String`	이메일 본문
`options`	`Object`	아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체

고급 매개변수

이름	유형	설명
`attachments`	`BlobSource[]`	이메일과 함께 보낼 파일의 배열 (예 참조)
`bcc`	`String`	숨은참조에 쉼표로 구분된 이메일 주소 목록
`cc`	`String`	참조에 넣을 이메일 주소 쉼표로 구분된 목록
`htmlBody`	`String`	이 속성을 설정하면 HTML을 렌더링할 수 있는 기기에서 필수 본문 인수 대신 이 인수를 사용합니다. 이메일에 인라인 이미지가 있는 경우 HTML 본문에 `inlineImages` 필드(선택사항)를 추가할 수 있습니다.
`inlineImages`	`Object`	이미지 키(`String`)에서 이미지 데이터 (`BlobSource`)로의 매핑이 포함된 자바스크립트 객체입니다. `htmlBody` 매개변수가 사용되고 `<img src="cid:imageKey" />` 형식의 이미지 참조가 포함된다고 가정합니다.
`name`	`String`	이메일 발신자의 이름 (기본값: 사용자 이름)
`noReply`	`Boolean`	수신자가 이메일에 응답하지 못하도록 일반 회신 없는 이메일 주소에서 이메일을 보내야 하는 경우 `true`. 이 옵션은 Gmail 사용자가 아닌 Google Workspace 계정에서만 사용할 수 있습니다.
`replyTo`	`String`	기본 답장 주소로 사용할 이메일 주소(기본값: 사용자의 이메일 주소)

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

참고 항목

sendEmail(message)

`sendEmail(to, replyTo, subject, body)`

이메일 메시지를 보냅니다. 사용자는 이 메서드를 통해 보낸 메시지에 발신자와 다를 수 있는 답장 주소를 쉽게 지정할 수 있습니다.

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

매개변수

이름	유형	설명
`to`	`String`	쉼표로 구분된 수신자 주소
`replyTo`	`String`	답장받을 주소
`subject`	`String`	제목
`body`	`String`	일반 텍스트로 된 이메일 본문

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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