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

:SingleSendMail

最終更新日:Nov 09, 2025

このトピックでは、SingleSendMail 操作を呼び出して単一のメールを送信する方法について説明します。 SingleSendMail 操作は、添付ファイルの送信をサポートしていません。

デバッグ

OpenAPI Explorer でこの操作を直接呼び出すことができます。 これにより、署名を計算する手間が省けます。 呼び出しが成功すると、OpenAPI Explorer は自動的にソフトウェア開発キット (SDK) のコード例を生成します。

リクエストパラメーター

名前

タイプ

必須

説明

AccountName

String

はい

test***@example.net

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

AddressType

Integer

はい

1

送信元アドレスのタイプ。 有効な値:

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

  • 1: 送信元アドレス

ReplyToAddress

String

はい

true

コンソールで設定した返信先アドレスを使用するかどうかを指定します。 返信先アドレスのステータスは検証済みである必要があります。 有効な値は文字列の "true" と "false" であり、ブール値ではありません。

Subject

String

はい

件名

メールの件名。 件名は 100 文字以内にする必要があります。

ToAddress

String

はい

test1***@example.net

受信者アドレス。 複数の受信者アドレスを指定できます。 コンマ (,) で区切ります。 最大 100 個の受信者アドレスを指定できます。 アカウントグループがサポートされています。

Action

String

いいえ

SingleSendMail

必須パラメーター。 値を SingleSendMail に設定します。

ClickTrace

String

いいえ

0

  • 1: データ追跡を有効にします。

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

FromAlias

String

いいえ

Xiao Hong

送信者エイリアス。 エイリアスは 15 文字以内にする必要があります。

たとえば、送信者エイリアスを "Alice" に、送信元アドレスを test***@example.net に設定すると、受信者には "Alice" <test***@example.net> と表示されます。

HtmlBody

String

いいえ

本文

メールの HTML 本文。 サイズはソフトウェア開発キット (SDK) によって 80 KB に制限されます。 注: HtmlBody と TextBody はメールの内容を指定します。 いずれかを指定する必要があります。

TagName

String

いいえ

test

Direct Mail コンソールで作成するタグ。 タグを使用してメールバッチを分類し、各バッチの送信ステータスをクエリできます。 メールトラッキングを有効にする場合は、メールタグを使用する必要があります。

TextBody

String

いいえ

本文

メールのテキスト本文。 サイズは SDK によって 80 KB に制限されます。 注: HtmlBody と TextBody はメールの内容を指定します。 いずれかを指定する必要があります。

ReplyAddress

String

いいえ

test2***@example.net

返信先アドレス。

ReplyAddressAlias

String

いいえ

Xiaohong

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

UnSubscribeLinkType

String

いいえ

default

生成するサブスクライブ解除リンクのタイプ。 詳細については、「サブスクライブ解除機能」をご参照ください。

  • Disabled: 生成は無効です。

  • デフォルト: バッチタイプの送信元アドレスから、「gmail」や「yahoo」などのキーワードを含む特定のドメイン名に送信されるメールに、サブスクライブ解除リンクが生成されること、

"google"、"aol.com"、"hotmail"、

"outlook"、"ymail.com" などのキーワードを含む特定のドメイン名に送信されるバッチタイプの送信元アドレスからのメールに対して、サブスクライブ解除リンクが生成されます

  • zh-cn: 将来のコンテンツイベントトラッキング用に生成されます。

  • en-us: 将来のコンテンツイベントトラッキング用に生成されます。

UnSubscribeFilterLevel

String

いいえ

mailfrom_domain

フィルタリングレベル。 詳細については、「サブスクライブ解除機能」をご参照ください。

  • disabled: フィルターしません。

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

  • mailfrom: 送信元アドレスレベルでフィルターします。

  • mailfrom_domain: 送信元ドメイン名レベルでフィルターします。

  • edm_id: アカウントレベルでフィルターします。

レスポンスパラメーター

名前

タイプ

説明

EnvId

String

xxxxxx

イベント ID。

RequestId

String

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

リクエスト ID。

リクエストの例

https://dm.aliyuncs.com/?Action=SingleSendMail&AccountName=test***@example.net&AddressType=1&ReplyToAddress=true&Subject=Subject&ToAddress=test1***@example.net&<共通リクエストパラメーター>

レスポンスの例

XML 形式

<SingleSendMailResponse>      <EnvId>xxxxxx</EnvId>      <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></SingleSendMailResponse>

JSON 形式

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400

InvalidReceiverName.Malformed

指定された受信者名が不正な形式です。

受信者アドレスの形式が無効です。 アドレスにはアットマーク (@) を含める必要があります。 アカウント名とドメイン名には、文字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) のみを使用できます。

404

InvalidMailAddress.NotFound

指定されたメールアドレスが見つかりません。

送信元アドレスが見つかりません。

404

InvalidReceiver.NotFound

指定された受信者は無効です。

受信者が存在しません。 受信者アドレスが有効かどうかを確認してください。

400

InvalidToAddress

指定された toAddress が不正な形式です。

受信者アドレスの形式が無効です。 アドレスにはアットマーク (@) を含める必要があります。 アカウント名とドメイン名には、文字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) のみを使用できます。

400

InvalidToAddress.Spam

無効なアドレスによりメール送信が拒否されました。

アドレスが無効です。 アドレスの有効性を確認してください。

400

InvalidBody

指定された textBody または htmlBody が不正な形式です。

TextBody または HtmlBody の形式が無効です。 内容を再度指定してください。

400

InvalidSendMail.Spam

迷惑メールフィルターによりメール送信が拒否されました。

メールの送信に失敗しました。 頻度制限の超過やクォータ不足など、ユーザーステータスに問題がないか確認してください。

400

InvalidMailAddressSendType.Malformed

指定された mailAddress sendType が不正な形式です。

送信タイプが無効です。 コンソールに移動してタイプを確認し、それに応じて値を設定してください。

400

InvalidMailAddressStatus.Malformed

指定された mailAddress ステータスが不正な形式です。

送信元アドレスのステータスが無効です。 アドレスがアクティブか凍結されているかを確認してください。

400

InvalidMailAddressDomain.Malformed

指定された mailAddress ドメインが存在しません。

ドメイン名の形式が無効です。 文字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) のみを使用できます。

400

InvalidSubject.Malformed

指定された件名は無効です。 100 文字を超えてはなりません。

件名は無効です。 100 文字以内にする必要があります。

400

InvalidFromAlias.Malformed

指定された fromAlias が不正な形式です。

送信者エイリアスの形式が無効です。 15 文字以内にする必要があります。

400

InvalidReplyAddressAlias.Malformed

指定された replyAddressAlias が不正な形式です。

返信先アドレスのエイリアスの形式が無効です。 15 文字以内にする必要があります。

400

InvalidReplyAddress.Malformed

指定された replyAddress が不正な形式です。

返信先アドレスの形式が無効です。 アドレスにはアットマーク (@) を含める必要があります。 アカウント名とドメイン名には、文字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) のみを使用できます。

404

InvalidIP.NotFound

指定された IP アドレスは無効です。

指定された IP アドレスは無効です。 IP 保護を有効にしている場合は、IP アドレスがリストに含まれていることを確認してください。

400

InvalidFromALias.Malformed

指定された fromAlias が不正な形式です。

送信者エイリアスが無効です。 送信者エイリアスを確認してください。 15 文字未満にする必要があります。

エラーコードの詳細については、「エラーセンター」をご参照ください。