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 bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

send()

Bu taslak e-posta iletisini gönderir. E-postanın boyutu (başlıklar dahil) kotayla 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 mesaj

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 (başlıklar dahil) kotayla 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-posta gövdesi

Return

GmailDraft - yeni güncellenen taslak

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden 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 şunları içerebilir: düz metin veya HTML gövdesi ekleyebilirsiniz. E-postanın boyutu (başlıklar dahil) kotayla 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-posta gövdesi
optionsObjectaşağıda listelenen, gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
attachmentsBlobSource[] e-postayla gönderilecek dosya dizisi
bccStringBCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
fromStringe-postanın gönderildiği adres (doğru adres olmalıdır) GmailApp.getAliases() tarafından döndürülen değerlerden
htmlBodyStringayarlanmışsa HTML oluşturabilen cihazlar bunun yerine bunu kullanır gerekir. HTML'ye isteğe bağlı bir inlineImages alanı ekleyebilirsiniz E-postanız için satır içi resimler varsa gövde metni
inlineImagesObjectresim anahtarından eşleme içeren bir JavaScript nesnesi (String) görüntü verilerine (BlobSource) göre; htmlBody parametresinin kullanıldığı ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiği varsayılır
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 bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

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