Gmail API'yi kullanarak e-posta göndermenin iki yolu vardır:
- Doğrudan
messages.send
yöntemini kullanarak gönderebilirsiniz. - E-postayı
drafts.send
yöntemini kullanarak taslaktan gönderebilirsiniz.
E-postalar, mesaj kaynağının raw
özelliği içinde base64url kodlamalı dizeler olarak gönderilir. E-posta göndermek için gereken ü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 yeni 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ını 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 mesajının 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, üstbilgiler de dahil olmak üzere e-posta iletisinin nasıl oluşturulacağı gösterilmektedir:
Sonraki adım MimeMessage
kodunu 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 bunu Message
kaynağının raw
alanına atama gösterilmektedir:
Ekleri olan mesajlar oluşturma
Ek içeren bir mesaj oluşturmak, başka herhangi bir mesaj oluşturmaya benzer ancak dosyayı çok parçalı MIME mesajı olarak yükleme işlemi programlama diline bağlıdır. Aşağıdaki kod örneklerinde, ekli çok parçalı bir MIME mesajı oluşturmanın olası yolları gösterilmektedir.
Java
Aşağıdaki örnekte çok parçalı 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, mesajı base64url'ye kodlamayı ve Message
kaynağının raw
alanına atamayı da ele alır.
İ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 dizisinde olmasını istiyorsanız aşağıdakilerden emin olun:
Subject
başlıkları eşleşiyorReferences
veIn-Reply-To
üstbilgileri, RFC 2822 standardını uygular.
Taslaktan ileti gönderme hakkında bilgi için Taslak Oluşturma bölümüne bakın.