Email API untuk layanan paket lama

Aplikasi App Engine dapat mengirim pesan email atas nama alamat penerima email aplikasi dan atas nama beberapa pengguna dengan Akun Google. Aplikasi dapat menerima email di berbagai alamat. Aplikasi mengirim pesan menggunakan layanan Email dan menerima pesan dalam bentuk permintaan HTTP yang dimulai oleh App Engine dan diposting ke aplikasi.

Mengirim email

Layanan Email dapat mengirim pesan email ke satu atau beberapa penerima. Pesan berisi subjek, isi teks biasa, dan isi HTML opsional. Pesan juga dapat berisi lampiran file dan serangkaian header terbatas.

Anda dapat menggunakan alamat email apa pun sebagai penerima. Penerima dapat berada di kolom "to" dalam pesan, di kolom "cc", atau disembunyikan dari penerima pesan ("blind carbon copy" atau "bcc").

Saat aplikasi memanggil layanan Email untuk mengirim pesan, pesan akan dimasukkan ke dalam antrean, dan panggilan akan segera menampilkan. Layanan Email menggunakan prosedur standar untuk menghubungi server email setiap penerima, mengirimkan pesan, dan mencoba lagi jika server email tidak dapat dihubungi.

Siapa yang dapat mengirim email

Untuk tujuan keamanan, alamat pengirim pesan harus berupa salah satu dari berikut ini:

  • Akun Gmail atau Google Workspace pengguna yang saat ini login
  • Alamat email apa pun dalam format anything@[MY_PROJECT_ID].appspotmail.com atau anything@[MY_PROJECT_NUMBER].appspotmail.com
  • Alamat email apa pun yang tercantum di konsol Google Cloud pada Pengirim Resmi Email API

Semua alamat email dalam daftar Pengirim Resmi Email API harus berupa akun Gmail atau domain yang dihosting Google yang valid. Administrator Aplikasi dapat menambahkan akun berikut ke daftar Pengirim Resmi:

  • Alamat emailnya sendiri
  • Semua grup dengan mereka sebagai Pemilik atau Pengelola
  • Aplikasi yang dihosting di domain Google Workspace: noreply@[DOMAIN].com, asalkan noreply@[DOMAIN].com adalah akun yang valid (pengguna atau grup).

Selain itu, administrator domain dari domain yang dikelola oleh Google Workspace dapat menambahkan pengguna dalam domain mereka ke daftar pengirim resmi.

Anda dibatasi hingga maksimum 50 pengirim resmi.

Email dari Google Workspace

Jika Anda akan mengirim email dari domain yang dikelola oleh Google Workspace, Anda harus menyetel kumpulan data SPF DNS untuk domain Anda guna menunjukkan bahwa Google adalah sumber tepercaya untuk email Anda. Untuk mengetahui petunjuk cara melakukannya, lihat data SPF di Pusat Bantuan Google Workspace.

Perlu diperhatikan bahwa jika Anda menggunakan alias yang disiapkan untuk domain Google Workspace, Anda tidak dapat mengirim email dari alamat email yang menggunakan alias domain.

Notifikasi saat email tidak terkirim

Email yang cocok dengan tanda yang diketahui untuk spam, virus, atau konten berbahaya lainnya mungkin tidak akan diterima untuk dikirimkan.

Jika layanan Email tidak dapat mengirimkan pesan, atau jika server email penerima menampilkan pesan email tidak terkirim (misalnya, karena tidak ada akun untuk alamat tersebut di sistem tersebut), pesan error dapat dikirim melalui email ke alamat pengirim pesan itu. Aplikasi itu sendiri tidak menerima notifikasi apa pun tentang apakah pengiriman berhasil atau gagal.

Secara default, notifikasi email tidak terkirim tidak diaktifkan. Untuk menerima notifikasi email tidak terkirim, Anda harus mengonfigurasi aplikasi Anda.

Email dan server pengembangan

Saat aplikasi yang berjalan di server pengembangan memanggil layanan Email untuk mengirim pesan email, pesan akan dicetak ke log aplikasi. Server pengembangan tidak mengirim pesan email.

Autentikasi dengan DomainKeys Identified Mail (DKIM)

Saat Anda mengirim email, App Engine menggunakan standar DomainKeys Identified Mail (DKIM) untuk mengautentikasi domain. Jika aplikasi Anda mengirim pesan dari alamat email yang merupakan bagian dari domain Google Workspace, App Engine dapat menandatangani email yang dikirimkan secara kriptografis. Tanda tangan ini menyatakan bahwa email yang seolah-olah berasal dari emma@example.com benar-benar berasal dari example.com. Penerima dapat memeriksa tanda tangan ini; jika tanda tangan benar, penerima tahu bahwa domain pengirim tidak terkena serangan spoofing.

Guna mengaktifkan autentikasi DKIM untuk pesan yang dikirim dari alamat email Google Workspace, ikuti petunjuk ini di Pusat Bantuan Google Workspace. Perlu diperhatikan bahwa diperlukan waktu hingga 48 jam sebelum autentikasi DKIM aktif untuk domain Google Workspace Anda.

Anda juga harus memastikan bahwa aplikasi menggunakan domain kustom dan sama dengan domain Google Workspace Anda. Perlu diperhatikan juga bahwa domain Google Workspace dengan subdomain seperti subdomain.example.com tidak diizinkan.

App Engine akan menandatangani email keluar aplikasi jika alamat pengirim merupakan bagian dari domain Google Workspace dengan DKIM yang diaktifkan. Selain itu, alamat pengirim harus diformat sedemikian rupa sehingga bagian domain alamat email hanya terdiri dari huruf kecil.

Kuota dan batas

Untuk melihat penggunaan kuota aplikasi Anda saat ini, buka halaman Detail Kuota di konsol Google Cloud.

Buka halaman Detail Kuota

Setiap permintaan layanan Email akan mengurangi kuota Panggilan Mail API. Terdapat uga kuota untuk jumlah pesan yang dapat Anda kirim, jumlah pesan Admin yang dapat Anda kirim, serta jumlah data dan lampiran yang dapat Anda kirim. Untuk mengetahui detail selengkapnya, lihat kuota Email.

Kuota direset setiap hari. Jika melebihi kuota harian, Anda akan mendapatkan pengecualian melebihi kuota. Jika Anda perlu mengirim email lebih banyak daripada yang diizinkan oleh kuota, Anda dapat menggunakan penyedia email pihak ketiga, seperti SendGrid.

Selain kuota, batas berikut berlaku untuk layanan Email:

Batas Jumlah
Ukuran maksimum pesan email keluar, termasuk lampiran 31,5 MB
Ukuran maksimum pesan email masuk, termasuk lampiran 31,5 MB
Ukuran maksimum pesan jika administrator adalah penerima 16 KB
Jumlah maksimum pengirim resmi 50

Langkah selanjutnya