Class GmailDraft

GmailDraft

Kullanıcının Gmail hesabında kullanıcı tarafından oluşturulan ileti taslağı.

Yöntemler

YöntemDönüş türüKısa açıklama
deleteDraft()voidBu taslak mesajı 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)GmailDraftİsteğe bağlı bağımsız değişkenleri kullanarak bu taslak iletinin içeriğini değiştirir.

Ayrıntılı belgeler

deleteDraft()

Bu taslak mesajı siler.

const 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 biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getId()

Bu taslak iletinin kimliğini alır.

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

Return

String: Taslak kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası 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.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 biri veya daha fazlası 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.

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

Return

String: İleti kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası 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 ile sınırlıdır.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 biri veya daha fazlası 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 ile sınırlıdır.

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

Parametreler

AdTürAçıklama
recipientStringVirgülle ayrılmış e-posta adresi listesi
subjectStringE-postanın konusu (en fazla 250 karakter)
bodyStringe-postanın gövdesi

Return

GmailDraft: Yeni güncellenen taslak

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası 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)

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

// Update a draft email with a file from Google Drive attached as a PDF.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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
recipientStringVirgülle ayrılmış e-posta adresi listesi
subjectStringE-postanın konusu (en fazla 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 alanına eklenecek e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi
fromStringE-postanın gönderileceği adres. Bu adres, GmailApp.getAliases() tarafından döndürülen değerlerden biri olmalıdır.
htmlBodyStringAyarlanmışsa 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. Bu, htmlBody parametresinin kullanıldığını ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiğini varsayar.
nameStringE-postanın göndereninin 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 biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

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