SaveReceiverDetail の呼び出しによる受信者リストへの受信者の追加 - DirectMail

単一の受信者の作成

説明

単一の受信者を作成します。

リクエストパラメーター

名前	タイプ	必須	説明
Action	String	はい	必須パラメーターです。値を SaveReceiverDetail に設定します。
ReceiverId	String	はい	受信者リストの ID。
Detail	String	はい	内容です。一度に複数の受信者をアップロードできます。1 回のアップロードで最大 500 レコードまでです。各レコードは中括弧 `{}` で囲み、カンマで区切ります。例: [{ },{ },{ }...]。`{}` 内のコンテンツのフォーマットは次のとおりです。 [{"b":"birthday","e":"xxx@example.net","g":"gender","m":"mobile","n":"nickname","u":"name"}]。値はリストではなく、文字列として渡します。重複した受信者アドレスを挿入すると、操作はエラー "ErrorCount": 1 を返します。

その他のリクエストパラメーターの詳細については、「共通リクエストパラメーター」をご参照ください。

レスポンスパラメーター

名前	型	例	説明
ErrorCount	Integer	638	エラーの数です。
RequestId	String	10A1AD70-E48E-476D-98D9-39BD92193837	リクエストの ID です。
SuccessCount	Integer	274	成功した操作の数です。
Data	Object []		アップロードに失敗したメールアドレスのリストです。
Email	String	te**@example.net	メールアドレスです。

例

リクエストの例

http(s)://dm.aliyuncs.com/?Action=SaveReceiverDetail
&ReceiverId=34642
&Detail=[{"b":"birthday","e":"xxx@example.net","g":"gender","m":"mobile","n":"nickname","u":"name"}]
&<Common request parameters>

レスポンスの例

JSON フォーマット

{
  "RequestId": "CA225B85-DC42-520D-84A3-0B8FF424CA9C",
  "Data": {
    "Detail": []
  },
  "ErrorCount": 0,
  "SuccessCount": 1
}

エラーレスポンスの例

{
  "RequestId": "1A32A629-49E4-52C6-ACA9-E5ED77A7A53B",
  "Data": {
    "Detail": [
      {
        "Email": "xxx@example.net"
      }
    ]
  },
  "ErrorCount": 1,
  "SuccessCount": 0
}