Bu belgede, Gmail API'yi kullanarak taslak e-postaların nasıl oluşturulacağı, güncelleneceği ve gönderileceği açıklanmaktadır.
E-posta taslakları, DRAFT sistem etiketi uygulanmış, gönderilmemiş iletileri temsil eder.
Taslakta yer alan ileti, oluşturulduktan sonra düzenlenemez ancak değiştirilebilir. Bu anlamda, temel mesaj kimlikleri her mesaj değiştirildiğinde değiştiği için drafts kaynağı, sabit bir kimlik sağlayan bir kapsayıcıdır.
Taslak içindeki messages kaynağı, aşağıdaki farklar dışında diğer iletilerle benzer davranışlara sahiptir:
- Taslak iletilerde
DRAFTsistem etiketi dışında etiket bulunamaz. - Taslak gönderildiğinde otomatik olarak silinir ve
SENTsistem etiketiyle güncellenmiş kimliğe sahip yeni bir ileti oluşturulur. Bu mesaj,drafts.sendyöntemi yanıtında döndürülür.
Taslak oluşturma
Uygulamanız, drafts.create yöntemini kullanarak taslak oluşturabilir. Taslak oluşturmak için:
- RFC 2822 ile uyumlu bir MIME iletisi oluşturun.
- İletiyi Base64URL kodlu bir dizeye dönüştürün.
drafts.createyöntemini çağırın vemessages.rawalanının değerini kodlanmış dize olarak ayarlayın.
Aşağıdaki kod örneklerinde bu işlem gösterilmektedir:
Java
Python
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
Aşağıdakini değiştirin:
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
- MESSAGE: RFC 2822 biçiminde MIME mesajı, base64URL olarak kodlanmış.
Taslakları güncelle
Taslak oluşturmaya benzer şekilde, taslağı güncellemek için isteğinizin gövdesinde drafts
kaynağını, messages.raw alanı MIME mesajını içeren bir base64URL kodlu dize olarak ayarlanmış şekilde sağlamanız gerekir. İletiler güncellenemediğinden taslakta bulunan ileti silinir ve güncelleme isteğinde sağlanan yeni MIME iletisiyle değiştirilir.
format=raw sorgu parametresiyle drafts.get yöntemini çağırarak taslakta bulunan mevcut MIME mesajını alabilirsiniz.
Daha fazla bilgi için drafts.update
yöntemine bakın.
Taslakları gönderme
Taslak gönderirken olduğu gibi gönderebilir veya gönderme isteğinde güncellemeler sağlayabilirsiniz.
Gönderirken taslağı güncellemek için drafts.send yönteminin istek gövdesinde bir drafts kaynağı sağlayın. drafts kaynağında, gönderilecek taslağın id sürümünü belirtmeniz ve messages.raw alanını base64URL dizesi olarak kodlanmış yeni MIME mesajına ayarlamanız gerekir.
Gmail iletisi gönderme hakkında bilgi edinmek için İleti gönderme başlıklı makaleyi inceleyin.