Class GmailDraft

GmailDraft

Bir kullanıcının Gmail hesabında kullanıcı tarafından oluşturulan taslak ileti.

Yöntemler

YöntemDönüş türüKısa açıklama
deleteDraft()voidBu taslak iletiyi siler.
getId()StringBu taslak iletinin kimliğini alır.
getMessage()GmailMessageBu taslağı temsil eden bir GmailMessage'ı döndürür.
getMessageId()StringBu taslağı temsil eden GmailMessage kimliğini döndürür.
send()GmailMessageBu taslak e-posta iletisini gönderir.
update(recipient, subject, body)GmailDraftBu taslak iletinin içeriğini değiştirir.
update(recipient, subject, body, options)GmailDraftBu taslak iletinin içeriğini isteğe bağlı bağımsız değişkenler kullanarak değiştirir.

Ayrıntılı belgeler

deleteDraft()

Bu taslak iletiyi siler.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage(); // Throws exception.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getId()

Bu taslak iletinin kimliğini alır.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var draftId = draft.getId();
var draftById = GmailApp.getDraft(draftId);
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Return

String - taslak kimlik

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getMessage()

Bu taslağı temsil eden bir GmailMessage'ı döndürür.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var message = draft.getMessage();
Logger.log(message.getSubject());

Return

GmailMessage: Bu taslağın içeriğini temsil eden mesaj

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getMessageId()

Bu taslağı temsil eden GmailMessage kimliğini döndürür.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var messageId = draft.getMessageId();
Logger.log(messageId == draft.getMessage().getId());

Return

String - ileti kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

send()

Bu taslak e-posta iletisini gönderir. E-postanın boyutu (üstbilgiler dahil) kota sınırlıdır.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var msg = draft.send(); // Send it
Logger.log(msg.getDate()); // Should be approximately the current timestamp

Return

GmailMessage — yeni gönderilen ileti

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

update(recipient, subject, body)

Bu taslak iletinin içeriğini değiştirir. E-postanın boyutu (üstbilgiler dahil) kota sınırlıdır.

// The code below will update a draft email with the current date and time.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var now = new Date();
draft.update("mike@example.com", "current time", "The time is: " + now.toString());

Parametreler

AdTürAçıklama
recipientStringe-posta adreslerinin virgülle ayrılmış listesi
subjectStringe-postanın konusu (maksimum 250 karakter)
bodyStringe-postanın gövdesi

Return

GmailDraft — yeni güncellenen taslak

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

Aşağıdaki kaynakları da incelemenizi öneririz:


update(recipient, subject, body, options)

Bu taslak iletinin içeriğini isteğe bağlı bağımsız değişkenler kullanarak değiştirir. E-posta düz metin veya bir HTML gövdesi içerebilir. E-postanın boyutu (üstbilgiler dahil) kota sınırlıdır.

// Update a draft email with a file from Google Drive attached as a PDF.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parametreler

AdTürAçıklama
recipientStringe-posta adreslerinin virgülle ayrılmış listesi
subjectStringe-postanın konusu (maksimum 250 karakter)
bodyStringe-postanın gövdesi
optionsObjectaşağıda listelendiği gibi, gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
attachmentsBlobSource[]e-postayla gönderilecek bir dosya dizisi
bccStringBCC'ye e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
fromStringe-postanın gönderilmesi gereken adres (GmailApp.getAliases() tarafından döndürülen değerlerden biri olmalıdır)
htmlBodyStringayarlanırsa HTML oluşturabilen cihazlar, gerekli gövde bağımsız değişkeni yerine bunu kullanır. E-postanızda satır içi resimler varsa HTML gövdesine isteğe bağlı bir inlineImages alanı ekleyebilirsiniz
inlineImagesObjectresim anahtarından (String) resim verilerine (BlobSource) eşleme içeren bir JavaScript nesnesi; htmlBody parametresinin kullanıldığı varsayılır ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerir.
nameStringe-postayı gönderenin adı (varsayılan: kullanıcının adı)
replyToStringvarsayılan yanıt adresi olarak kullanılacak bir e-posta adresi (varsayılan: kullanıcının e-posta adresi)

Return

GmailDraft — yeni güncellenen taslak

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

Aşağıdaki kaynakları da incelemenizi öneririz: