Kullanıcının Gmail hesabında kullanıcı tarafından oluşturulan ileti taslağı.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
delete | void | Bu taslak mesajı siler. |
get | String | Bu taslak iletinin kimliğini alır. |
get | Gmail | Bu taslağı temsil eden bir GmailMessage döndürür. |
get | String | Bu taslağı temsil eden Gmail kimliğini döndürür. |
send() | Gmail | Bu taslak e-posta iletisini gönderir. |
update(recipient, subject, body) | Gmail | Bu taslak iletinin içeriğini değiştirir. |
update(recipient, subject, body, options) | Gmail | İ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
| Ad | Tür | Açıklama |
|---|---|---|
recipient | String | Virgülle ayrılmış e-posta adresi listesi |
subject | String | E-postanın konusu (en fazla 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 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
| Ad | Tür | Açıklama |
|---|---|---|
recipient | String | Virgülle ayrılmış e-posta adresi listesi |
subject | String | E-postanın konusu (en fazla 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 | Blob | E-postayla gönderilecek bir dosya dizisi |
bcc | String | BCC alanına eklenecek 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önderileceği adres. Bu adres, Gmail tarafından döndürülen değerlerden biri olmalıdır. |
html | String | Ayarlanmış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 inline alanı ekleyebilirsiniz. |
inline | Object | Resim anahtarından (String) resim verilerine (Blob) eşleme içeren bir JavaScript nesnesi. Bu, html parametresinin kullanıldığını ve bu resimlere <img src="cid:imageKey" /> biçiminde referanslar içerdiğini varsayar. |
name | String | E-postanın göndereninin adı (varsayılan: kullanıcının adı) |
reply | 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 biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:
-
https://mail.google.com/