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

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

매개변수

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

고급 매개변수

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