Gmail API'yi kullanarak e-posta göndermenin iki yolu vardır:
- Doğrudan
messages.send
yöntemini kullanarak gönderebilirsiniz. drafts.send
yöntemini kullanarak bir taslaktan gönderebilirsiniz.
E-postalar bir mesaj kaynağının raw
özelliği içinde base64url olarak kodlanmış dizeler olarak gönderilir. E-posta göndermek için üst düzey iş akışı:
- E-posta içeriğini uygun bir şekilde oluşturun ve bunu bir base64url dizesi olarak kodlayın.
- Yeni bir mesaj kaynağı oluşturun ve mesajın
raw
özelliğini, az önce oluşturduğunuz Base64url dizesine ayarlayın. messages.send
numaralı telefonu arayın veya taslak gönderiyorsanız mesajı göndermek içindrafts.send
uygulamasını kullanın.
Bu iş akışının ayrıntıları, istemci kitaplığı ve programlama dili seçiminize bağlı olarak değişebilir.
Mesaj oluşturma
Gmail API'si, RFC 2822 ile uyumlu MIME e-posta iletilerinin kullanılmasını ve base64url dizelerinin kodlanmasını gerektirir. Birçok programlama dilinde MIME iletileri oluşturma ve kodlama sürecini basitleştiren kitaplıklar veya yardımcı programlar vardır. Aşağıdaki kod örnekleri, çeşitli diller için Google API'leri istemci kitaplıklarını kullanarak nasıl MIME mesajı oluşturulacağını gösterir.
Java
javax.mail.internet
paketindeki MimeMessage
sınıfıyla e-posta iletisi oluşturma işlemi büyük ölçüde kolaylaştırılabilir. Aşağıdaki örnekte, üstbilgiler de dahil olmak üzere e-posta iletisinin nasıl oluşturulacağı gösterilmektedir:
Sonraki adım, MimeMessage
kodlamasını yapmak, bir Message
nesnesini örneklere eklemek ve Base64url kodlu mesaj dizesini raw
özelliğinin değeri olarak ayarlamaktır.
Python
Aşağıdaki kod örneği, bir MIME iletisi oluşturmayı, Base64url dizesine kodlamayı ve Message
kaynağının raw
alanına atamayı göstermektedir:
Ekli iletiler oluşturma
Ek içeren bir ileti oluşturmak, başka bir ileti oluşturmaya benzer, ancak dosyayı çok parçalı bir MIME iletisi olarak yükleme işlemi programlama diline bağlıdır. Aşağıdaki kod örnekleri, eki olan çok parçalı bir MIME iletisi oluşturmanın olası yollarını göstermektedir.
Java
Aşağıdaki örnekte çok parçalı bir MIME iletisinin nasıl oluşturulacağı gösterilmektedir. Yukarıdaki kodlama ve atama adımları aynıdır.
Python
Önceki örnekte olduğu gibi bu örnek, mesajı Base64url olarak kodlamayı ve Message
kaynağının raw
alanına atamayı da kapsar.
Mesaj gönderme
Bir mesaj oluşturduktan sonra mesajı, aşağıdaki örneklerde gösterildiği gibi messages.send
çağrısının istek gövdesinde sağlayarak gönderebilirsiniz.
Java
Python
Yanıt göndermeye çalışıyorsanız ve e-postanın ileti dizisi haline getirilmesini istiyorsanız aşağıdakilerden emin olun:
Subject
üstbilgileri eşleşiyorReferences
veIn-Reply-To
başlıkları RFC 2822 standardını uygular.
Taslaktan ileti gönderme hakkında bilgi edinmek için Taslak Oluşturma sayfasına göz atın.