Direct Mail:SingleSendMail

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

アドレスタイプです。有効な値：

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

• 1：送信元アドレス

DirectMail コンソールで作成するタグです。タグはメールバッチの分類に使用します。タグによって各バッチの送信ステータスをクエリできます。メールトラッキング機能が有効な場合は、メール送信時にメールタグを使用する必要があります。値の長さは 1～128 文字で、英字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。

コンソールで設定した返信先アドレス (検証済みである必要があります) を使用するかどうかを指定します。有効な値は true または false です。

宛先アドレスです。コンマで区切って複数のメールアドレスを指定できます。最大 100 件のアドレスを指定できます (メーリングリストにも対応しています)。

メールの件名です。長さは最大 256 文字です。

メールの HTML 本文です。

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

• URL ベースのパラメーター渡しのサイズ制限は約 80 KB です。

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

メールのテキスト本文です。

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

• URL ベースのパラメーター渡しのサイズ制限は約 80 KB です。

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

送信者のニックネームです。長さは最大 15 文字です。

たとえば、送信者のニックネームを「田中一郎」に設定し、送信元アドレスが test***@example.net の場合、受信者には送信元アドレスが「田中一郎」 <test***@example.net> と表示されます。

返信先アドレスです。

返信先アドレスのニックネームです。

データトラッキングを有効にするかどうかを指定します。有効な値：

• 1：データトラッキングを有効にします。

• 0 (デフォルト)：データトラッキングを無効にします。

購読解除リンクのタイプです。有効な値：

• disabled：購読解除リンクは生成されません。

• default：デフォルトポリシーが適用されます。「gmail」、「yahoo」、「google」、「aol.com」、「hotmail」、「outlook」、「ymail.com」などのキーワードを含む特定のドメインにバッチタイプの送信元アドレスからメールが送信される場合、購読解除リンクが生成されます。詳細については、「購読解除リンクの生成とフィルタリングメカニズム」をご参照ください。

表示言語は、受信者のブラウザ設定に基づいて自動的に検出されます。

フィルタリングレベルです。詳細については、「購読解除リンクの生成とフィルタリングメカニズム」をご参照ください。

有効な値：

• disabled：フィルタリングは適用されません。

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

• mailfrom：送信元アドレスレベルのフィルタリング。

• mailfrom_domain：送信元ドメインレベルのフィルタリング。

• edm_id：アカウントレベルのフィルタリング。

メールヘッダーの設定です。

標準フィールドと非標準フィールドは両方とも、標準で定義されているヘッダーの構文要件に準拠する必要があります。API 経由でメールを送信する場合、headers フィールドを通じて最大 10 個のヘッダーを渡すことができます。この制限を超えたヘッダーは無視されます。SMTP にはそのような制限はありません。

1. 標準フィールド

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

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

2. 非標準フィールド

大文字と小文字は区別されません。

a. X-User- で始まるフィールド (EventBridge または Message Service MNS にはプッシュされません。これは API のみの要件です。SMTP では任意のカスタムフィールドを使用できます。)

b. X-User-Notify- で始まるフィールド (EventBridge および Message Service MNS にプッシュされます。API と SMTP の両方でサポートされています。)

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

専用 IP プールの ID です。専用 IP アドレスを購入したユーザーは、このパラメーターを使用してこのメールのアウトバウンド IP アドレスを指定できます。詳細については、「専用 IP アドレス」をご参照ください。

• メールの BCC (ブラインドカーボンコピー) 受信者リストを指定します。

• システムは、メインのメールコンテンツと同一のコピーを各 BCC アドレスに送信します。BCC の情報は、どの受信者 (ToAddress および BccAddress を含む) にも表示されません。

• BCC 受信者のプライバシーを保護するため、BCC メールではメールトラッキング機能がデフォルトで無効になっています。これは、システムが BCC メールの開封率やクリック率などの行動データを記録しないことを意味します。ただし、送信ボリューム、送信詳細、送信ステータスの統計に関する課金は、通常のメールと一致しています。

• 送信ごとに最大 2 人の BCC 受信者を指定できます。

注：SingleSendMail API は CC (カーボンコピー) フィールドをサポートしていません。この機能が必要な場合は、SMTP を使用してください。

ドメインレベル認証を有効にするかどうかを指定します。有効な値：

• true

• false

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

1. コンソールでアドレス domain-auth-created-by-system@example.com を作成します。@ の前のプレフィックスは変更せず、サフィックスとして独自のドメイン名を使用してください。

API シナリオ

AccountName をドメインのカスタム送信元アドレスに設定します。受信者には、カスタム送信元アドレスが送信者として表示されます。

SMTP シナリオ

a. ModifyPWByDomain API を介してドメインパスワードを設定します。

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