すべてのプロダクト
Search

このプロダクト

    :BatchSendMail

    ドキュメントセンター

    :BatchSendMail

    最終更新日:Feb 05, 2026

    複数のメールをバッチで送信します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    dm:BatchSendMail

    none

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    TemplateName

    string

    必須

    事前に作成および承認されたテンプレートの名前。

    test1
    AccountName

    string

    必須

    コンソールで設定された送信元アドレス。

    test@example.com
    ReceiversName

    string

    必須

    受信者がアップロードされている、事前に作成された受信者リストの名前。

    注意事項：

    リスト内の受信者数は、残りの日次割当クォータを超えてはなりません。超えた場合、メール送信は失敗します。

    タスクをトリガーしてから少なくとも 10 分間は、受信者リストを削除しないでください。削除した場合、メール送信が失敗する可能性があります。

    test2
    AddressType

    integer

    必須

    • 0：ランダムアカウント

    • 1：送信元アドレス

    1
    TagName

    string

    任意

    メールタグの名前。

    test3
    ReplyAddress

    string

    任意

    返信先アドレス。

    test2***@example.net
    ReplyAddressAlias

    string

    任意

    返信先アドレスのエイリアス。

    小红
    ClickTrace

    string

    任意

    • 1：データ追跡機能を有効にします。

    • 0 (デフォルト)：データ追跡機能を無効にします。

    0
    UnSubscribeLinkType

    string

    任意

    生成する配信停止リンクのタイプ。詳細については、「配信停止リンクの生成とフィルタリングの仕組み」をご参照ください。

    • disabled：リンクを生成しません。

    • default：デフォルトのポリシーを使用します。バッチメールが送信元アドレスから、「gmail」、「yahoo」、「google」、「aol.com」、「hotmail」、「outlook」、「ymail.com」などのキーワードを含む特定のドメインに送信される場合、配信停止リンクが生成されます。

    配信停止リンクの言語は、受信者のブラウザの言語設定と一致します。

    default
    UnSubscribeFilterLevel

    string

    任意

    フィルタリングレベル。詳細については、「配信停止リンクの生成とフィルタリングの仕組み」をご参照ください。

    • disabled：フィルタリングなし。

    • default：デフォルトのポリシーを使用します。バッチメールは送信元アドレスレベルでフィルタリングされます。

    • mailfrom：送信元アドレスレベルでフィルタリングします。

    • mailfrom_domain：メールドメインレベルでフィルタリングします。

    • edm_id：アカウントレベルでフィルタリングします。

    mailfrom_domain
    Headers

    string

    任意

    メッセージヘッダーの設定。

    標準フィールドか非標準フィールドかにかかわらず、すべてのフィールドは標準のヘッダー構文に従う必要があります。API 呼び出しの場合、`headers` フィールドは最大 10 個のヘッダーをサポートします。この制限を超えるヘッダーは無視されます。SMTP にはヘッダーの制限はありません。

    1. 標準フィールド

    `Message-ID`、`List-Unsubscribe`、`List-Unsubscribe-Post`

    標準フィールドは、メッセージヘッダー内の既存の値を上書きします。

    2. 非標準フィールド

    大文字と小文字を区別しません

    a. `X-User-` で始まります。これらのフィールドは EventBridge や Message Service にプッシュされません。API 呼び出しでのみ必要です。SMTP は任意のカスタムヘッダーをサポートします。

    b. `X-User-Notify-` で始まります。これらのフィールドは EventBridge と Message Service にプッシュされます。API と SMTP の両方でサポートされています。

    EventBridge または Message Service にプッシュされると、これらのフィールドは `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

    任意

    専用 IP アドレスプールの ID。専用 IP アドレスを購入した場合、このパラメーターを使用してメール送信時の送信 IP アドレスを指定します。

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

    boolean

    任意

    ドメインレベル認証を有効にします。

    • true

    • false

    このパラメーターはドメインレベル認証にのみ使用します。送信元アドレスレベル認証の場合は無視してください。

    1. コンソールは `domain-auth-created-by-system@example.com` というアドレスを作成します。アットマーク (@) の前のプレフィックスは変更しないでください。ドメインサフィックスを独自のドメインに置き換えてください。

    2.

    API シナリオ

    `AccountName` をご利用のドメインに設定します。受信者には送信者として `domain-auth-created-by-system@example.com` が表示されます。

    SMTP シナリオ

    a. `ModifyPWByDomain` API を使用して、ご利用のドメインのパスワードを設定します。

    b. ご利用のドメインとパスワードを使用して認証します。実際の送信元アドレス (`mailfrom`) を `user@example.com` などのカスタムアドレスに設定します。受信者には送信者として `user@example.com` が表示されます。

    true

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    EnvId

    string

    イベント ID。

    xxx
    RequestId

    string

    リクエスト ID。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。