すべてのプロダクト
Search
ドキュメントセンター

Direct Mail:BatchSendMail

最終更新日:Jun 26, 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

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

  1. 非標準フィールド

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

a. X-User- プレフィックス付きのフィールド (EventBridge またはメッセージサービス (MNS) にはプッシュされません。この制限は API にのみ適用されます。SMTP では任意のカスタムフィールドが許可されます。)

b. X-User-Notify- プレフィックス付きのフィールド (EventBridge およびメッセージサービス (MNS) にプッシュされます。API と SMTP の両方がサポートされます。)

EventBridge または MNS にプッシュされる場合、これらのフィールドは header フィールドの下に含まれます。

{ "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 を作成します。@ の前のプレフィックスは変更せず、サフィックスを自分のドメイン名に置き換えてください。

API シナリオ

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

SMTP シナリオ

a. ModifyPWByDomain 操作を呼び出してドメインパスワードを設定します。

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

true

TemplateContent

object

任意

カスタムメールコンテンツ。事前にテンプレートを作成せずにコンテンツを直接指定できます。このパラメーターまたは TemplateName を指定します。TemplateContent と TemplateName の両方が指定された場合、TemplateName が優先されます。

Subject

string

任意

メールの主題。

黑色星期五,专属折扣来袭

HtmlBody

string

任意

メールの HTML 本文。

注意: HtmlBody と TextBody は異なるタイプのメールコンテンツに使用されます。いずれか一方を指定する必要があります。

新しい SDK では Body を使用してパラメーターを渡し、サイズ制限は約 8 MB です (Java 1.4.0 以降、Python3 1.4.0 以降、PHP 1.4.0 以降)。

全场九折,仅限今日

TextBody

string

任意

メールのプレーンテキスト本文。

注意: HtmlBody と TextBody は異なるタイプのメールコンテンツに使用されます。いずれか一方を指定する必要があります。

新しい SDK では Body を使用してパラメーターを渡し、サイズ制限は約 8 MB です (Java 1.4.0 以降、Python3 1.4.0 以降、PHP 1.4.0 以降)。

全场九折,仅限今日

Alias

string

任意

送信者の表示名。

Jackie

Receivers

array<object>

任意

受信者リスト。受信者数は 100 を超えることはできません。このパラメーターまたは ReceiversName を指定します。Receivers と ReceiversName の両方が指定された場合、ReceiversName が優先されます。

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

array<object>

任意

カスタム受信者の詳細。

To

array

任意

受信者リスト。このパラメーターは配列タイプです。

string

任意

メールアドレス。

Jackie@example.com

TemplateData

object

任意

メールテンプレートパラメーター。このパラメーターは JSON マップタイプです。

string

任意

key-value 字符串

{"UserName": "Jackie"}

レスポンスフィールド

フィールド

説明

object

EnvId

string

イベント ID。

xxx

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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