Belgelere geç
Python

Taslaklar

`drafts.list`, `list_all`, `iterate`, `get`, `create`, `update` ve `delete`.

Her yöntem

usage.py
from openemail import openemail page = openemail.drafts.list(query='invoice', limit=25)draft = openemail.drafts.get('draft_…') created = openemail.drafts.create({    'to': ['[email protected]'],    'cc': [],    'bcc': [],    'subject': 'Your September invoice',    'html': '<p>Draft body.</p>',    'from': '[email protected]',    'threadId': 'thread_…',}) draft_id = created['id'] if draft_id is not None:    openemail.drafts.update(draft_id, {'subject': 'Revised'})    openemail.drafts.delete(draft_id)

update taslağın id'sini korur; dolayısıyla döndürdüğü değer her zaman geçirdiğiniz id'dir. Bilinmeyen bir id yeni bir taslak değil, 404 verir.

list, threads.list ile aynı şekilde sayfalar: API'nin pageToken değeri nextCursor olarak döner ve cursor olarak girer; list_all ve iterate bunu sizin için izler.

Bir taslağı göndermek için id'sini emails.send çağrısına geçirin. İçeriği taslak, zarfı ise gönderim sağlar.

send_draft.py
from openemail import openemail openemail.emails.send({    'from': '[email protected]',    'to': '[email protected]',    'draftId': 'draft_…',})

Parametreler: drafts.create ve drafts.update (DraftInput)

tolist[str]
Alıcı adresleri düz dizgeler olarak verilir, `emails.send` çağrısının kabul ettiği `RecipientInput` biçimleri olarak değil; çünkü bu uç nokta diziyi sürücünün istediği virgülle ayrılmış listeye birleştirir. Oluştururken belirtilmeyen bir dizi boş olarak kaydedilir; güncellerken belirtilmeyen bir alan saklanan alıcılara dokunmaz, çünkü işleyici önce taslağı okuyup birleştirir.
cclist[str]
Cc adresleri, `to` ile aynı düz dizge biçiminde. Oluştururken belirtilmezse boş, güncellerken belirtilmezse dokunulmadan kalır.
bcclist[str]
Bcc adresleri, `to` ile aynı düz dizge biçiminde. Oluştururken belirtilmezse boş, güncellerken belirtilmezse dokunulmadan kalır.
subjectstr
Taslağın konusu, en fazla 998 karakter; bu RFC 5322 satır sınırıdır. Oluştururken varsayılanı boş dizgedir, dolayısıyla bir taslağın her zaman bir konusu olur.
htmlstr
Taslağın işaretleme biçimindeki gövdesi, en fazla 1.000.000 karakter. Kazanan gövde budur: `html` ve `text`, sürücünün tek mesaj alanını besler; dolayısıyla ikisini birden göndermek bunu saklar.
textstr
Düz metin gövde, en fazla 1.000.000 karakter; yalnızca `html` yokken kullanılır. Taslak iki parça değil tek bir gövde sakladığı için burada verilen metin, taslak okunduğunda `html` alanında geri gelir.
fromstr
Taslağa kaydedilecek gönderen adresi. Güncellerken belirtilmezse saklanan taslaktan aktarılır. Sürücü mesajın tamamını kendisine verilenden yeniden kurar; dolayısıyla bu alanı düşüren kısmi bir yama, seçilen göndereni sessizce değiştirirdi.
threadIdstr
Taslağı var olan bir konuşma dizisine bağlayarak yanıt olarak kaydedin. `from` gibi, güncellerken belirtilmezse aktarılır; çünkü mesajı bu olmadan yeniden kurmak yanıtı dizisinden koparırdı.

Yanıt: DraftResource (drafts.get)

objectLiteral['draft']
Her zaman `draft`.
idstr
Taslağın id'si. Yazma işlemleri taslağın tamamı yerine bir `SavedDraftResource` döndürür; bu yüzden gönderdiğiniz id'yi yeniden kullanmak yerine id'yi sonuçtan okuyun.
tolist[str]
Taslağın sakladığı hâliyle alıcı adresleri. Taslağın hiç alıcısı yoksa `None` değil, boş liste.
cclist[str]
Saklanan hâliyle Cc adresleri. Taslakta hiç yoksa `None` değil, boş liste.
bcclist[str]
Saklanan hâliyle Bcc adresleri. Taslakta hiç yoksa `None` değil, boş liste.
subjectstr
Saklanan konu ya da taslakta konu yoksa boş dize. Bu alan asla `None` olmaz; bu yüzden varlığını değil uzunluğunu denetleyin.
htmlstr
Saklanan gövde ya da taslakta gövde yoksa boş dizge. Çıkışta ayrı bir metin alanı yoktur: yalnızca `text` ile kaydedilmiş bir taslak burada döndürülür.

Referans