Gmail API'yi kullanarak iki şekilde e-posta gönderebilirsiniz:
messages.send
yöntemini kullanarak doğrudan gönderebilirsiniz.- E-postayı
drafts.send
yöntemini kullanarak taslaktan gönderebilirsiniz.
E-postalar, mesaj kaynağının raw
özelliği içinde base64url kodlu dizeler olarak gönderilir. E-posta göndermek için kullanılan üst düzey iş akışı:
- E-posta içeriğini uygun bir şekilde oluşturun ve base64url dizesi olarak kodlayın.
- Yeni bir mesaj kaynağı oluşturun ve
raw
özelliğini, az önce oluşturduğunuz base64url dizesine ayarlayın. messages.send
numaralı telefonu arayın. Taslak gönderiyorsanız mesajı göndermek içindrafts.send
numaralı telefonu arayın.
Bu iş akışının ayrıntıları, seçtiğiniz istemci kitaplığına ve programlama diline bağlı olarak değişiklik gösterebilir.
Mesaj oluşturma
Gmail API, RFC 2822 ile uyumlu ve base64url dizeleri olarak kodlanmış MIME e-posta iletileri gerektirir. Birçok programlama dilinde, MIME mesajları oluşturma ve kodlama sürecini basitleştiren kitaplıklar veya yardımcı programlar bulunur. Aşağıdaki kod örnekleri, çeşitli diller için Google API'leri istemci kitaplıklarını kullanarak MIME iletisinin nasıl oluşturulacağını göstermektedir.
Java
javax.mail.internet
paketindeki MimeMessage
sınıfı ile e-posta mesajı oluşturma işlemi büyük ölçüde kolaylaştırılabilir. Aşağıdaki örnekte, başlıklar da dahil olmak üzere e-posta iletisinin nasıl oluşturulacağı gösterilmektedir:
Sonraki adım MimeMessage
öğesini kodlamak, bir Message
nesnesi örneklendirmek ve base64url olarak kodlanmış mesaj dizesini raw
özelliğinin değeri olarak ayarlamaktır.
Python
Aşağıdaki kod örneğinde, MIME mesajı oluşturma, base64url dizesine kodlama ve bunun Message
kaynağının raw
alanına atanması gösterilmektedir:
Ekleri olan mesajlar oluşturma
Ekli bir ileti oluşturmak, diğer herhangi bir iletiyi oluşturmaya benzer ancak dosyayı çok parçalı MIME iletisi olarak yükleme işlemi, programlama diline bağlıdır. Aşağıdaki kod örneklerinde, ekli çok parçalı bir MIME iletisi oluşturmanın olası yolları gösterilmektedir.
Java
Aşağıdaki örnekte, çok parçalı bir MIME mesajının nasıl oluşturulacağı gösterilmektedir. Kodlama ve atama adımları yukarıdakiyle aynıdır.
Python
Önceki örneğe benzer şekilde bu örnek de mesajı base64url olarak kodlamayı ve Message
kaynağının raw
alanına atama işlemini işliyor.
İleti gönderme
Bir mesaj oluşturduktan sonra, aşağıdaki örneklerde gösterildiği gibi messages.send
çağrısının istek gövdesinde bu mesajı göndererek gönderebilirsiniz.
Java
Python
Yanıt göndermeye çalışıyor ve e-postanın ileti dizisi şeklinde olmasını istiyorsanız aşağıdakilerden emin olun:
Subject
başlıkları eşleşiyorReferences
veIn-Reply-To
üstbilgileri, RFC 2822 standardını izler.
Taslaktan ileti gönderme hakkında bilgi için Taslak Oluşturma bölümüne bakın.