Bir kullanıcının Gmail hesabında kullanıcı tarafından oluşturulan taslak ileti.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
deleteDraft() | void | Bu taslak iletiyi siler. |
getId() | String | Bu taslak iletinin kimliğini alır. |
getMessage() | GmailMessage | Bu taslağı temsil eden bir GmailMessage'ı döndürür. |
getMessageId() | String | Bu taslağı temsil eden GmailMessage kimliğini döndürür. |
send() | GmailMessage | Bu taslak e-posta iletisini gönderir. |
update(recipient, subject, body) | GmailDraft | Bu taslak iletinin içeriğini değiştirir. |
update(recipient, subject, body, options) | GmailDraft | Bu 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
Ad | Tür | Açıklama |
---|---|---|
recipient | String | e-posta adreslerinin virgülle ayrılmış listesi |
subject | String | e-postanın konusu (maksimum 250 karakter) |
body | String | e-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
Ad | Tür | Açıklama |
---|---|---|
recipient | String | e-posta adreslerinin virgülle ayrılmış listesi |
subject | String | e-postanın konusu (maksimum 250 karakter) |
body | String | e-postanın gövdesi |
options | Object | aşağıda listelendiği gibi, gelişmiş parametreleri belirten bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
attachments | BlobSource[] | e-postayla gönderilecek bir dosya dizisi |
bcc | String | BCC'ye e-posta adreslerinin virgülle ayrılmış listesi |
cc | String | CC'ye eklenecek e-posta adreslerinin virgülle ayrılmış listesi |
from | String | e-postanın gönderilmesi gereken adres (GmailApp.getAliases() tarafından döndürülen değerlerden biri olmalıdır) |
htmlBody | String | ayarlanı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 |
inlineImages | Object | resim 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. |
name | String | e-postayı gönderenin adı (varsayılan: kullanıcının adı) |
replyTo | String | varsayı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/