Tüm Ürünler
Search

Bu Ürün

    :BatchSendMail

    Belge Merkezi

    :BatchSendMail

    Son Güncelleme:Sep 30, 2026

    E-postaları toplu olarak gönderir.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dm:BatchSendMail

    none

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    TemplateName

    string

    No

    Önceden oluşturulmuş ve onaylanmış bir şablonun adı.

    test1
    AccountName

    string

    Yes

    Yönetim konsolunda yapılandırılmış gönderen adresi.

    test@example.com
    ReceiversName

    string

    No

    Alıcıları yüklenmiş, önceden oluşturulmuş bir alıcı listesinin adı.

    Not:

    Listedeki alıcı sayısı, kalan günlük kotayı aşmamalıdır. Aksi takdirde e-posta gönderimi başarısız olur.

    Görev tetiklendikten sonra en az 10 dakika geçene kadar alıcı listesini silmeyin. Aksi takdirde e-posta gönderimi başarısız olabilir.

    test2
    AddressType

    integer

    Yes

    Geçerli değerler:

    • 0: rastgele hesap

    • 1: gönderen adresi.

    1
    TagName

    string

    No

    E-postanın etiket adı.

    test3
    ReplyAddress

    string

    No

    Yanıt adresi.

    test2***@example.net
    ReplyAddressAlias

    string

    No

    Yanıt adresinin diğer adı.

    小红
    ClickTrace

    string

    No

    Geçerli değerler:

    • 1: Veri izlemeyi etkinleştirir.

    • 0 (varsayılan): Veri izlemeyi devre dışı bırakır.

    0
    UnSubscribeLinkType

    string

    No

    Oluşturulan abonelikten çıkma bağlantısının türü. Daha fazla bilgi için Abonelikten çıkma bağlantısı oluşturma ve filtreleme mekanizması konusuna bakın. Geçerli değerler:

    • disabled: Abonelikten çıkma bağlantısı oluşturulmaz.

    • default: Varsayılan ilke kullanılır. Toplu türde bir gönderen adresinden "gmail", "yahoo", "google", "aol.com", "hotmail", "outlook" veya "ymail.com" gibi anahtar kelimeler içeren belirli etki alanlarına e-posta gönderildiğinde bir abonelikten çıkma bağlantısı oluşturulur.

    Görüntüleme dili, alıcının tarayıcı ayarlarına göre otomatik olarak belirlenir.

    default
    UnSubscribeFilterLevel

    string

    No

    Filtreleme seviyesi. Daha fazla bilgi için Abonelikten çıkma bağlantısı oluşturma ve filtreleme mekanizması konusuna bakın. Geçerli değerler:

    • disabled: Filtreleme uygulanmaz.

    • default: Varsayılan ilke kullanılır. Toplu adresler, gönderen adresi seviyesinde filtrelenir.

    • mailfrom: Gönderen adresi seviyesinde filtreleme.

    • mailfrom_domain: Gönderen etki alanı seviyesinde filtreleme.

    • edm_id: Hesap seviyesinde filtreleme.

    mailfrom_domain
    Headers

    string

    No

    E-posta üst bilgisi ayarları.

    Hem standart hem de standart olmayan alanlar, standartta tanımlanan üst bilgiler için sözdizimi gereksinimlerine uymalıdır. API aracılığıyla e-posta gönderirken headers alanı üzerinden en fazla 10 üst bilgi aktarılabilir. Bu sınırı aşan üst bilgiler yoksayılır. SMTP'de böyle bir sınır yoktur.

    1. Standart alanlar

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

    Standart alanlar, e-posta üst bilgisindeki orijinal değerlerin üzerine yazar.

    1. Standart olmayan alanlar

    Büyük/küçük harfe duyarlı değildir.

    a. X-User- ön ekli alanlar (EventBridge veya Message Service'e (MNS) aktarılmaz. Bu kısıtlama yalnızca API için geçerlidir. SMTP herhangi bir özel alana izin verir.)

    b. X-User-Notify- ön ekli alanlar (EventBridge ve Message Service'e (MNS) aktarılır. Hem API hem de SMTP desteklenir.)

    EventBridge veya MNS'ye aktarıldığında, bu alanlar header alanı altında yer alır.

    { "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

    Ayrılmış IP adresi havuzunun kimliği. Ayrılmış IP adresleri satın alan kullanıcılar, bu e-posta gönderim görevi için giden IP adresini belirtmek üzere bu parametreyi kullanabilir.

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

    boolean

    No

    Etki alanı düzeyinde kimlik doğrulamanın etkinleştirilip etkinleştirilmeyeceğini belirtir.

    Geçerli değerler:

    • true

    • false

    Bu parametreyi yalnızca etki alanı düzeyinde kimlik doğrulama için kullanın. Gönderen adresi düzeyinde kimlik doğrulama için dikkate almayın.

    1. Konsolda domain-auth-created-by-system@example.com adresini oluşturun. @ işaretinden önceki ön eki değiştirmeden bırakın ve son eki kendi etki alanı adınızla değiştirin.

    API senaryosu

    AccountName değerini etki alanı adı olarak ayarlayın. Alıcı, gönderen olarak domain-auth-created-by-system@example.com adresini görür.

    SMTP senaryosu

    a. Etki alanı parolasını ayarlamak için ModifyPWByDomain işlemini çağırın.

    b. Etki alanı adı ve yapılandırılmış parola ile kimlik doğrulaması yapın. Gerçek gönderen (mailfrom) olarak user@example.com gibi özel bir adres iletin. Alıcı, gönderen olarak user@example.com adresini görür.

    true
    TemplateContent

    object

    No

    Özel e-posta içeriği. Önceden bir şablon oluşturmadan içeriği doğrudan belirtebilirsiniz. Bu parametreyi veya TemplateName parametresini belirtin. Hem TemplateContent hem de TemplateName belirtilirse, TemplateName önceliklidir.

    Subject

    string

    No

    E-postanın konusu.

    黑色星期五，专属折扣来袭
    HtmlBody

    string

    No

    E-postanın HTML gövdesi.

    Not: HtmlBody ve TextBody farklı e-posta içeriği türleri için kullanılır. Bunlardan birini belirtmeniz gerekir.

    Yeni SDK, parametre aktarımı için yaklaşık 8 MB boyut sınırına sahip Body özelliğini kullanır (Java 1.4.0 ve üzeri, Python3 1.4.0 ve üzeri, PHP 1.4.0 ve üzeri).

    全场九折，仅限今日
    TextBody

    string

    No

    E-postanın düz metin gövdesi.

    Not: HtmlBody ve TextBody farklı e-posta içeriği türleri için kullanılır. Bunlardan birini belirtmeniz gerekir.

    Yeni SDK, parametre aktarımı için yaklaşık 8 MB boyut sınırına sahip Body özelliğini kullanır (Java 1.4.0 ve üzeri, Python3 1.4.0 ve üzeri, PHP 1.4.0 ve üzeri).

    全场九折，仅限今日
    Alias

    string

    No

    Gönderenin görünen adı.

    Jackie
    Receivers

    array<object>

    No

    Alıcı listesi. Alıcı sayısı 100'ü aşamaz. Bu parametreyi veya ReceiversName parametresini belirtin. Hem Receivers hem de ReceiversName belirtilirse, ReceiversName önceliklidir.

    Örnek: [{"To":["Jackie@example.com"],"TemplateData":{"UserName":"Jackie"}},{"To":["Tom@example.com"],"TemplateData":{"UserName":"Tom"}}].

    array<object>

    No

    Özel bir alıcının ayrıntıları.

    To

    array

    No

    Alıcı listesi. Bu parametre dizi türündedir.

    string

    No

    E-posta adresi.

    Jackie@example.com
    TemplateData

    object

    No

    E-posta şablonu parametreleri. Bu parametre JSON map türündedir.

    string

    No

    Anahtar-değer dizesi.

    {"UserName": "Jackie"}

    Response elements

    Element

    Type

    Description

    Example

    object

    EnvId

    string

    Olay kimliği.

    xxx
    RequestId

    string

    İstek kimliği.

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

    Examples

    Success response

    JSON format

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

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.