全部产品
Search
文档中心

Direct Mail:BatchSendMail

更新时间:Feb 05, 2026

Mengirim email secara batch.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

dm:BatchSendMail

none

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

TemplateName

string

Yes

Nama templat yang telah dibuat dan disetujui sebelumnya.

test1

AccountName

string

Yes

Alamat pengirim yang dikonfigurasi di Konsol.

test@example.com

ReceiversName

string

Yes

Nama daftar penerima yang telah dibuat sebelumnya dan ke dalamnya penerima telah diunggah.

Catatan:

Jumlah penerima dalam daftar tidak boleh melebihi kuota harian tersisa Anda. Jika tidak, pengiriman email akan gagal.

Jangan menghapus daftar penerima setidaknya selama 10 menit setelah memicu task. Jika tidak, pengiriman email mungkin gagal.

test2

AddressType

integer

Yes

  • 0: Akun acak

  • 1: Alamat pengirim

1

TagName

string

No

Nama tag email.

test3

ReplyAddress

string

No

Alamat balasan.

test2***@example.net

ReplyAddressAlias

string

No

Alias untuk alamat balasan.

小红

ClickTrace

string

No

  • 1: Mengaktifkan fitur pelacakan data.

  • 0 (default): Menonaktifkan fitur pelacakan data.

0

UnSubscribeLinkType

string

No

Tipe tautan berhenti berlangganan yang akan dibuat. Untuk informasi lebih lanjut, lihat Mekanisme pembuatan dan penyaringan tautan berhenti berlangganan.

  • disabled: Tidak membuat tautan.

  • default: Menggunakan kebijakan default. Tautan berhenti berlangganan dibuat saat email batch dikirim dari alamat pengirim ke domain tertentu, seperti yang mengandung kata kunci "gmail", "yahoo", "google", "aol.com", "hotmail", "outlook", atau "ymail.com".

Bahasa tautan berhenti berlangganan mengikuti pengaturan bahasa browser penerima.

default

UnSubscribeFilterLevel

string

No

Tingkat penyaringan. Untuk informasi lebih lanjut, lihat Mekanisme pembuatan dan penyaringan tautan berhenti berlangganan.

  • disabled: Tidak ada penyaringan.

  • default: Menggunakan kebijakan default. Email batch disaring berdasarkan tingkat alamat pengirim.

  • mailfrom: Penyaringan berdasarkan tingkat alamat pengirim.

  • mailfrom_domain: Penyaringan berdasarkan tingkat domain email.

  • edm_id: Penyaringan berdasarkan tingkat akun.

mailfrom_domain

Headers

string

No

Pengaturan header pesan.

Semua bidang, baik standar maupun non-standar, harus mengikuti sintaksis header standar. Untuk panggilan API, bidang `headers` mendukung hingga 10 header. Header tambahan di luar batas ini akan diabaikan. SMTP tidak memiliki batas jumlah header.

1. Bidang standar

`Message-ID`, `List-Unsubscribe`, `List-Unsubscribe-Post`

Bidang standar akan menimpa nilai yang sudah ada di header pesan.

2. Bidang non-standar

Tidak peka huruf besar/kecil

a. Diawali dengan `X-User-`. Bidang ini tidak didorong ke EventBridge atau Message Service. Hanya diperlukan untuk panggilan API. SMTP mendukung header kustom apa pun.

b. Diawali dengan `X-User-Notify-`. Bidang ini didorong ke EventBridge dan Message Service. Didukung oleh API maupun SMTP.

Ketika didorong ke EventBridge atau Message Service, bidang-bidang ini muncul di bawah objek `headers`.

{ "Message-ID": "", "X-User-UID1": "UID-1-000001", "X-User-UID2": "UID-2-000001", "X-User-Notify-UID1": "UID-3-000001", "X-User-Notify-UID2": "UID-4-000001" }

IpPoolId

string

No

ID kolam alamat IP khusus. Jika Anda telah membeli alamat IP khusus, gunakan parameter ini untuk menentukan alamat IP egress yang digunakan untuk mengirim email.

e4xxxxxe-4xx0-4xx3-8xxa-74cxxxxx1cef

DomainAuth

boolean

No

Mengaktifkan otentikasi tingkat domain.

  • true

  • false

Gunakan parameter ini hanya untuk otentikasi tingkat domain. Abaikan untuk otentikasi tingkat alamat pengirim.

1. Konsol membuat alamat `domain-auth-created-by-system@example.com`. Jangan mengubah awalan sebelum tanda @. Ganti sufiks domain dengan domain Anda sendiri.

2.

Skenario API

Atur `AccountName` ke domain Anda. Penerima akan melihat `domain-auth-created-by-system@example.com` sebagai pengirim.

Skenario SMTP

a. Gunakan API `ModifyPWByDomain` untuk menyetel password untuk domain Anda.

b. Lakukan otentikasi menggunakan domain dan password tersebut. Atur alamat pengirim aktual (`mailfrom`) ke alamat kustom, seperti `user@example.com`. Penerima akan melihat `user@example.com` sebagai pengirim.

true

Elemen respons

Element

Type

Description

Example

object

EnvId

string

ID event.

xxx

RequestId

string

ID permintaan.

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.