Dokumen ini menjelaskan cara mengonfigurasi penerusan email di Gmail API.
Anda dapat menggunakan
resource settings untuk
mengonfigurasi penerusan untuk akun. Untuk menggunakan alamat email untuk penerusan, alamat email tersebut harus memenuhi salah satu kriteria berikut:
- Alamat email telah diverifikasi. Untuk mengetahui informasi selengkapnya, lihat Membuat dan memverifikasi alamat penerusan.
- Alamat email berasal dari domain yang sama dengan pengirim.
- Alamat email tersebut adalah subdomain dalam domain yang sama dengan pengirim.
- Alamat email tersebut adalah milik alias domain yang dikonfigurasi sebagai bagian dari akun Google Workspace yang sama.
Jika alamat email penerusan tidak mematuhi salah satu aturan ini, penyiapan penerusan menggunakan API akan gagal.
Untuk mengetahui informasi tentang cara
membuat,
mencantumkan,
mendapatkan,
atau
menghapus
alamat penerusan, lihat metode di resource
settings.forwardingAddresses.
Untuk mengetahui informasi tentang cara
mendapatkan
atau
memperbarui
setelan penerusan otomatis, lihat metode di resource
settings.
Membuat dan memverifikasi alamat penerusan
Anda harus membuat alamat penerusan sebelum menggunakannya. Dalam beberapa kasus, pengguna juga harus memverifikasi kepemilikan alamat.
Jika Gmail mewajibkan verifikasi pengguna untuk alamat penerusan, API akan menampilkan alamat dengan
VerificationStatus
pending. Gmail akan otomatis mengirimkan pesan verifikasi ke alamat email target. Pemilik alamat email harus menyelesaikan proses verifikasi sebelum Anda dapat menggunakannya.
Alamat penerusan yang tidak memerlukan verifikasi memiliki status verifikasi
accepted.
Mengaktifkan penerusan otomatis
Anda dapat memilih untuk meneruskan semua pesan baru ke alamat email lain.
Untuk melakukannya, panggil metode
updateAutoForwarding
untuk mengaktifkan penerusan otomatis untuk akun. Panggilan ini memerlukan alamat penerusan yang terdaftar dan terverifikasi serta tindakan yang akan dilakukan pada pesan yang diteruskan.
Tetapkan nilai ini dalam objek
AutoForwarding.
Gunakan kolom
disposition
untuk menetapkan status pesan setelah pesan diteruskan. Meskipun nilai defaultnya adalah dispositionUnspecified, Anda tidak dapat menyetel kolom ini ke dispositionUnspecified.
Contoh kode berikut menunjukkan cara mengaktifkan penerusan otomatis, lalu memindahkan pesan yang diteruskan ke sampah:
Java
Python
Untuk menonaktifkan penerusan otomatis, panggil metode
updateAutoForwarding
dan tetapkan kolom
enabled
pada objek AutoForwarding ke false.
Meneruskan pesan tertentu
Penerusan otomatis mengirimkan semua pesan Gmail yang diterima ke akun target. Untuk meneruskan pesan tertentu, siapkan filter untuk membuat aturan yang meneruskan pesan sebagai respons terhadap atribut atau konten pesan.
Untuk meneruskan pesan ke beberapa akun, buat filter untuk setiap alamat email penerusan.