Class GmailDraft

GmailTaslak

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 mesajı siler.
getId()StringBu taslak mesajın kimliğini alır.
getMessage()GmailMessageBu taslağı temsil eden bir GmailMessage döndürür.
getMessageId()StringBu taslağı temsil eden GmailMessage öğesinin kimliğini döndürür.
send()GmailMessageBu taslak e-posta mesajını gönderir.
update(recipient, subject, body)GmailDraftBu taslak mesajın 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ı dokümanlar

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

  • https://mail.google.com/

getId()

Bu taslak mesajın 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getMessageId()

Bu taslağı temsil eden GmailMessage öğesinin 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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

send()

Bu taslak e-posta mesajını gönderir. E-postanın boyutu (üstbilgiler dahil) kota sınırına ulaştı.

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

  • https://mail.google.com/

update(recipient, subject, body)

Bu taslak mesajın içeriğini değiştirir. E-postanın boyutu (üstbilgiler dahil) kota sınırına ulaştı.

// 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
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 bir veya daha fazlasıyla veya ilgili REST API'deki 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övde içerebilir. E-postanın boyutu (üstbilgiler dahil) kota sınırına ulaştı.

// 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
recipientStringe-posta adreslerinin virgülle ayrılmış listesi
subjectStringe-postanın konusu (maksimum 250 karakter)
bodyStringe-postanın gövdesi
optionsObjectAşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
attachmentsBlobSource[]E-postayla gönderilecek bir dosya dizisi
bccStringGizli alıcının e-posta adreslerinin virgülle ayrılmış listesi
ccStringCC alanına 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.
htmlBodyStringAyarlanırsa HTML oluşturabilen cihazlar, zorunlu body bağımsız değişkeni yerine bunu kullanır. E-postanız için satır içi resimler eklediyseniz HTML gövdesine isteğe bağlı bir inlineImages alanı ekleyebilirsiniz
inlineImagesObjectResim anahtarından (String) resim verilerine (BlobSource) bir eşleme içeren bir JavaScript nesnesi; bu durumda htmlBody parametresinin kullanıldığı ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiği varsayılır
nameStringE-postayı gönderen kişinin adı (varsayılan: kullanıcının adı)
replyToStringVarsayılan yanıtlama adresi olarak kullanılacak 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 veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

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