全部产品
Search
文档中心

:BatchSendMail

更新时间:Nov 10, 2025

Anda dapat memanggil operasi BatchSendMail untuk mengirim email secara batch.

Pengujian

Anda dapat menjalankan operasi ini langsung di OpenAPI Explorer tanpa perlu menghitung tanda tangan. Setelah pemanggilan berhasil, OpenAPI Explorer akan secara otomatis menghasilkan contoh kode SDK.

Parameter permintaan

Nama

Tipe

Diperlukan

Contoh

Deskripsi

AccountName

String

Ya

test@example.com

Alamat pengirim yang dikonfigurasi di Konsol.

AddressType

Integer

Ya

1

  • 0: Akun acak

  • 1: Alamat pengirim

ReceiversName

String

Ya

test2

Nama daftar penerima yang telah dibuat sebelumnya dengan penerima yang diunggah. Catatan: Untuk mencegah kegagalan pengiriman, tunggu setidaknya 10 menit setelah tugas dipicu sebelum Anda menghapus daftar penerima.

TemplateName

String

Ya

test1

Nama templat yang telah dibuat sebelumnya dan telah disetujui.

Action

String

Tidak

BatchSendMail

Parameter yang diperlukan. Tetapkan nilainya ke BatchSendMail.

ClickTrace

String

Tidak

0

  • 1: Mengaktifkan pelacakan data.

  • 0 (default): Menonaktifkan pelacakan data.

TagName

String

Tidak

test3

Nama tag email.

ReplyAddress

String

Tidak

test2***@example.net

Alamat balasan.

ReplyAddressAlias

String

Tidak

Alice

Alias untuk alamat balasan.

UnSubscribeLinkType

String

Tidak

default

Menentukan jenis tautan berhenti berlangganan yang akan dihasilkan. Untuk informasi selengkapnya, lihat dokumen Petunjuk Fitur Berhenti Berlangganan.

  • Disabled: Pembuatan dinonaktifkan.

  • default: Menggunakan kebijakan default. Tautan berhenti berlangganan dihasilkan saat Anda mengirim email dari alamat pengirim batch ke domain tertentu, seperti domain yang mengandung kata kunci seperti "gmail", "yahoo",

"google", "aol.com", "hotmail",

"outlook", atau "ymail.com".

  • Generated for future instrumentation.

  • en-us: Menghasilkan tautan. Ini dicadangkan untuk instrumentasi konten di masa mendatang.

UnSubscribeFilterLevel

String

Tidak

mailfrom_domain

Tingkat filter. Untuk informasi selengkapnya, lihat Bantuan Fitur Berhenti Berlangganan.

  • disabled: Tanpa penyaringan.

  • default: Menggunakan kebijakan default. Alamat pengirim batch difilter pada tingkat alamat pengirim.

  • mailfrom: Memfilter pada tingkat alamat pengirim.

  • mailfrom_domain: Memfilter pada tingkat domain email.

  • edm_id: Memfilter pada tingkat akun.

Parameter respons

Nama

Tipe

Contoh

Deskripsi

EnvId

String

xxx

ID event.

RequestId

String

12D086F6-8F31-4658-84C1-006DED011A85

ID permintaan.

Contoh

Contoh permintaan

https://dm.aliyuncs.com/?Action=BatchSendMail
&AccountName=test@example.com
&AddressType=1
&ReceiversName=test2
&TemplateName=test1
&<Common request parameters>

Contoh respons sukses

XML format

<BatchSendMailResponse>
      <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
      <EnvId>xxx</EnvId>
</BatchSendMailResponse>

JSON format

{
        "EnvId":"xxx",
        "RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"
}

Kode kesalahan

Kode status HTTP

Kode kesalahan

Pesan kesalahan

Deskripsi

400

InvalidMailAddressName.Malformed

Nama MailAddress yang ditentukan salah formatnya.

Alamat pengirim dalam format yang tidak valid. Alamat harus mengandung tanda at (@). Nama domain dapat berisi angka, huruf, garis bawah (_), tanda hubung (-), dan titik (.). Nama akun dapat berisi angka, huruf, garis bawah (_), tanda hubung (-), dan titik (.).

400

InvalidReceiverName.Malformed

Nama penerima yang ditentukan salah formatnya.

Alamat penerima dalam format yang tidak valid. Alamat harus mengandung tanda at (@). Nama domain dapat berisi angka, huruf, garis bawah (_), tanda hubung (-), dan titik (.). Nama akun dapat berisi angka, huruf, garis bawah (_), tanda hubung (-), dan titik (.).

400

InvalidTemplateName.Malformed

Nama templat yang ditentukan salah formatnya.

Nama templat dalam format yang tidak valid. Panjang nama templat tidak boleh melebihi 30 karakter.

404

InvalidMailAddress.NotFound

MailAddress yang ditentukan tidak ada.

Alamat pengirim yang ditentukan tidak ada. Periksa alamat pengirim.

404

InvalidTemplate.NotFound

Templat yang ditentukan tidak ada.

Templat yang ditentukan tidak ada.

404

InvalidReceiver.NotFound

Penerima yang ditentukan tidak ada.

Penerima tidak ada. Periksa apakah penerima tersebut ada.

400

InvalidSendMail.Spam

Pengiriman email ditolak oleh filter spam.

Pengiriman email ditolak. Periksa status pengguna terkait masalah seperti batas frekuensi terlampaui atau kuota tidak mencukupi.

400

InvalidMailAddressSendType.Malformed

Jenis pengiriman mailAddress yang ditentukan salah formatnya.

Jenis pengiriman tidak valid. Buka Konsol untuk memeriksa jenisnya dan tetapkan nilainya sesuai.

400

InvalidMailAddressStatus.Malformed

Status mailAddress yang ditentukan salah formatnya.

Alamat pengirim dalam status yang tidak valid. Periksa apakah alamat tersebut aktif atau dibekukan.

400

InvalidMailAddressDomain.Malformed

Domain mailAddress yang ditentukan tidak ada.

Nama domain dalam format yang tidak valid. Gunakan angka, huruf, garis bawah (_), tanda hubung (-), dan titik (.).

400

InvalidTemplateStatus.Malformed

Status templat yang ditentukan salah formatnya.

Templat dalam status yang tidak valid. Periksa apakah templat tersebut telah disetujui.

400

InvalidReceiverStatus.Malformed

Status penerima yang ditentukan salah formatnya.

Status penerima tidak valid. Buka Konsol untuk memeriksa apakah penerima telah diunggah.

400

InvalidReplyAddressAlias.Malformed

ReplyAddressAlias yang ditentukan salah formatnya.

Alias untuk alamat balasan dalam format yang tidak valid. Panjang alias tidak boleh melebihi 15 karakter.

400

InvalidReplyAddress.Malformed

ReplyAddress yang ditentukan salah formatnya.

Alamat balasan dalam format yang tidak valid. Alamat harus mengandung tanda at (@). Nama domain dapat berisi angka, huruf, garis bawah (_), tanda hubung (-), dan titik (.). Nama akun dapat berisi angka, huruf, garis bawah (_), tanda hubung (-), dan titik (.).

Untuk daftar kode kesalahan lainnya, kunjungi Pusat Kesalahan.