Mengelola status pengiriman dengan ekstensi Memicu Email
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Saat dokumen ditambahkan ke koleksi, ekstensi mengambilnya untuk pemrosesan pengiriman email. Ekstensi membuat dan memperbarui kolom delivery di dokumen saat ekstensi memproses email.
Pemrosesan pengiriman email
Kolom delivery dapat diisi dengan kolom berikut:
- state: Salah satu dari
PENDING, PROCESSING, SUCCESS, atau ERROR.
- startTime: Stempel waktu saat pemrosesan email dimulai.
- endTime: Stempel waktu saat pemrosesan email telah selesai (yaitu, diakhiri dengan status
SUCCESS atau ERROR).
- error: Jika terjadi error saat pengiriman email, pesan error akan terisi di sini.
- attempts: Jumlah upaya pengiriman untuk email ini.
- leaseExpireTime: Jika hang atau waktu tunggu habis, waktu saat status
PROCESSING harus dianggap sebagai error.
- info: Setelah pengiriman email berhasil (setidaknya ke satu alamat), kolom ini akan diisi dengan kolom berikut:
- messageId: ID pesan dari email yang dikirim.
- accepted: Array alamat email tempat email berhasil dikirim.
- rejected: Array alamat email yang menjadi tujuan email yang gagal dikirim.
- pending: Array alamat email yang untuk sementara ditolak oleh SMTP.
- response: Respons terakhir dari server SMTP.
Status email biasanya akan berubah dari PENDING ke PROCESSING lalu ke SUCCESS atau ERROR. Setelah berada dalam status SUCCESS atau ERROR, perubahan tambahan pada dokumen tidak akan memicu ekstensi untuk mengirim email lain. Untuk mengirim ulang email dengan pembaruan dokumen, Anda dapat mengubah state menjadi PENDING atau RETRY.
Percobaan ulang manual
Ada kalanya pengiriman email gagal tetapi masih dapat dipulihkan, atau dokumen dapat diperbaiki secara manual untuk dikirimkan lagi dengan benar dengan sedikit modifikasi. Saat percobaan ulang tidak ditetapkan ke otomatis, Anda dapat mengubah state di kolom delivery menjadi RETRY secara manual agar ekstensi kembali mencoba melakukan mengirimkan email (dan meningkatkan jumlah attempts).
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-14 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-14 UTC."],[],[],null,["\u003cbr /\u003e\n\nWhen a document is added to the collection, the extension picks it up for email\ndelivery processing. The extension creates and updates a `delivery` field in the\ndocument as it processes the email.\n\nEmail delivery processing\n\nThe `delivery` field can be populated with the following fields:\n\n- **state:** One of `PENDING`, `PROCESSING`, `SUCCESS`, or `ERROR`.\n- **startTime:** Timestamp when email processing began.\n- **endTime:** Timestamp when email processing completed (that is, ended in either a `SUCCESS` or `ERROR` state).\n- **error:** If there was an email delivery error, an error message will be populated here.\n- **attempts:** Number of delivery attempts for this email.\n- **leaseExpireTime:** In case of a hang or timeout, the time at which a `PROCESSING` state should be considered an error.\n- **info:** After successful email delivery (to at least one address), this field will be populated with the following fields:\n - **messageId:** The message ID of the delivered email.\n - **accepted:** Array of email addresses to which the email was successfully delivered.\n - **rejected:** Array of email addresses to which the email could not be delivered.\n - **pending:** Array of email addresses that were temporarily rejected by SMTP.\n - **response:** The last response from the SMTP server.\n\nAn email will typically go from `PENDING` to `PROCESSING` to either `SUCCESS` or\n`ERROR`. Once in the `SUCCESS` or `ERROR` state, additional changes to the\ndocument will not trigger the extension to send another email. To resend an\nemail with document updates, you can change the `state` to `PENDING` or `RETRY`.\n\nManual retries\n\nThere are instances in which email delivery fails in a recoverable fashion or\nthe document can be manually corrected for proper delivery with minor\nmodifications. While retries are not automatic, you can manually change the\n`state` in the `delivery` field to `RETRY` so that the extension attempts email\ndelivery again (and increments the number of `attempts`)."]]
