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

Direct Mail:SDK を使用して添付ファイル付きのメールを送信する方法

最終更新日:Nov 14, 2025

説明

添付ファイル付きのメールの合計サイズは 15 MB を超えることはできません。1 つのメールに含めることができる添付ファイルは最大 100 個です。

15 MB の制限は、メッセージヘッダー、本文、添付ファイルを含む、送信されるメールの合計サイズに適用されます。Base64 エンコーディングはファイルサイズを増加させるため、最終的なメールは元の添付ファイルのサイズの 1.5 倍以上になる可能性があります。したがって、添付ファイルの合計サイズを 8 MB 以下に制限することをお勧めします。より大きなファイルを送信するには、メール本文にそれらへのハイパーリンクを追加してください。

# -*- coding: utf-8 -*-
import sys
from typing import List
from typing import BinaryIO
from alibabacloud_dm20151123.client import Client as Dm20151123Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_dm20151123 import models as dm_20151123_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_dm20151123 import models as main_models

attachments = []


class Sample:
    def __init__(self) -> None:
        pass

    @staticmethod
    def create_client() -> Dm20151123Client:
        """
        認証情報を使用してアカウントクライアントを初期化します。
        @return: クライアント
        @throws Exception
        """
        # 本番コードでは、AccessKey ペアを必要としない、より安全な方法を使用することをお勧めします。認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/en/sdk/developer-reference/v2-manage-python-access-credentials をご参照ください。
        config = open_api_models.Config(
            access_key_id='xxxxxx',
            access_key_secret='xxxxxx'
        )
        # エンドポイントの詳細については、https://api.alibabacloud.com/product/Dm をご参照ください。
        config.endpoint = f'dm.ap-southeast-1.aliyuncs.com'
        config.region_id = f'ap-southeast-1'
        return Dm20151123Client(config)

    @staticmethod
    def main(
            args: List[str],
    ) -> None:
        client = Sample.create_client()
        single_sendmail_request = dm_20151123_models.SingleSendMailAdvanceRequest(
            account_name='sender@example.com',
            address_type='1',
            reply_to_address='true',
            to_address='recipient@example.com',
            subject='Subject',
            html_body='Email Body',
            attachments=getAttachments()
        )
        try:
            # コードをコピーして実行する際に、API の戻り値を表示します。
            response = client.single_send_mail_advance(single_sendmail_request, util_models.RuntimeOptions())
            print(response)
        except Exception as error:
            # これはデモンストレーションのみを目的としています。例外は慎重に処理してください。プロジェクトで例外を無視しないでください。
            # エラーメッセージ
            print(error.data)
            # # 診断アドレス
            # print(error.data.get("Recommend"))
            # UtilClient.assert_as_string(error.message)

def getAttachments() -> List[main_models.SingleSendMailAdvanceRequestAttachments]:
    attach = main_models.SingleSendMailAdvanceRequestAttachments("test1.txt", getFile(r"C:\Users\Downloads\111.txt"))
    attach1 = main_models.SingleSendMailAdvanceRequestAttachments("test2.txt", getFile(r"C:\Users\Downloads\222.txt"))
    attachments.append(attach)
    attachments.append(attach1)
    return attachments


def getFile(v_file) -> BinaryIO:
    f = open(v_file, 'rb')
    return f


if __name__ == '__main__':
    Sample.main(sys.argv[1:])
package org.example;

import com.aliyun.dm20151123.models.SingleSendMailAdvanceRequest;
import com.aliyun.dm20151123.models.SingleSendMailResponse;
import com.aliyun.tea.TeaException;
import com.google.gson.Gson;

import java.io.File;
import java.io.FileInputStream;
import java.util.ArrayList;
import java.util.List;

public class Sample {
    /**
     * 説明
<?php

// このファイルは自動生成されたものです。編集しないでください。ありがとうございます。
namespace AlibabaCloud\SDK\Sample;

use AlibabaCloud\SDK\Dm\V20151123\Dm;
// use AlibabaCloud\Credentials\Credential;
use \Exception;
use AlibabaCloud\Tea\Exception\TeaError;
use AlibabaCloud\Tea\Utils\Utils;

use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Dm\V20151123\Models\SingleSendMailAdvanceRequest;
use AlibabaCloud\SDK\Dm\V20151123\Models\SingleSendMailAdvanceRequest\attachments;
use GuzzleHttp\Psr7\Stream;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;

require_once __DIR__ . '\\..\\..\\vendor\\autoload.php';

class Sample {

    /**
     * 認証情報を使用してアカウントクライアントを初期化します。
     * @return Dm クライアント
     */
    public static function createClient(){
        // 本番コードでは、AccessKey ペアを必要としない、より安全な方法を使用することをお勧めします。認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/en/sdk/developer-reference/v2-manage-php-access-credentials をご参照ください。
        $config = new Config([
            "accessKeyId" => "xxxxxx",
            "accessKeySecret" => "xxxxxxx"
        ]);
        // エンドポイントの詳細については、https://api.alibabacloud.com/product/Dm をご参照ください。
        $config->endpoint = "dm.ap-southeast-1.aliyuncs.com";        
        $config->regionId = "ap-southeast-1";        
        return new Dm($config);
    }
    // public static function createClient(){
    //     // 本番コードでは、AccessKey ペアを必要としない、より安全な方法を使用することをお勧めします。認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/document_detail/311677.html をご参照ください。
    //     $credential = new Credential();
    //     $config = new Config([
    //         "credential" => $credential
    //     ]);
    //     // エンドポイントの詳細については、https://api.aliyun.com/product/Dm をご参照ください。
    //     $config->endpoint = "dm.aliyuncs.com";
    //     $config->regionId = "cn-hangzhou";
    //     return new Dm($config);
    // }
    /**
     * ファイルストリームを取得します。
     * @param string $filePath ファイルパス。
     * @return Stream
     */
    public static function getFile($filePath) {
        $fileResource = fopen($filePath, 'rb');
        $fileSize = filesize($filePath); // ファイルサイズを取得します。
        var_dump("File size:");
        var_dump($fileSize);
        return new Stream($fileResource);
    }

    /**
     * 添付ファイルリストを取得します。
     * @return array
     */
    public static function getAttachments() {
        $attachments = [];
        
        // 最初の添付ファイルを作成します。
        $attachment1 = new attachments();
        $attachment1->attachmentName = "test1.txt";
        $attachment1->attachmentUrlObject = self::getFile("C:\\Users\\Downloads\\111.txt");
        $attachments[] = $attachment1;
        
        // 2 番目の添付ファイルを作成します。
        $attachment2 = new attachments();
        $attachment2->attachmentName = "test2.txt";
        $attachment2->attachmentUrlObject = self::getFile("C:\\Users\\Downloads\\222.txt");
        $attachments[] = $attachment2;
        // $attachments を出力します。
        var_dump($attachments);
        return $attachments;
    }

    /**
     * @param string[] $args
     * @return void
     */
    public static function main($args){
        $client = self::createClient();
        
        // メールリクエストを作成します。
        $singleSendMailRequest = new SingleSendMailAdvanceRequest([
            "accountName" => "sender@example.com",
            "addressType" => 1,
            "replyToAddress" => true,
            "subject" => "Subject",
            "toAddress" => "recipient@example.com",            
            "attachments" => self::getAttachments(),
            "htmlBody" => "<h1>Body</h1>",
            "textBody" => "Body"
        ]);
        
        // // ランタイムオプションを作成します。
        // $runtime = new RuntimeOptions([
        //     "ca" => "C:\\Users\\cacert.pem" // ローカル CA 証明書パスを指定します。
        // ]);
        $runtime = new RuntimeOptions();
        
        try {
            // メールを送信します。
            $client->singleSendMailAdvance($singleSendMailRequest, $runtime);
            var_dump("Sent successfully");
        }
        catch (Exception $error) {
            if (!($error instanceof TeaError)) {
                $error = new TeaError([], $error->getMessage(), $error->getCode(), $error);
            }
            // これはデモンストレーションのみを目的としています。例外は慎重に処理してください。プロジェクトで例外を無視しないでください。
            // エラーメッセージ
            var_dump($error->message);
            // 診断アドレス
            var_dump($error->data["Recommend"]);
            Utils::assertAsString($error->message);
        }
    }
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
if (file_exists($path)) {
    require_once $path;
}
Sample::main(array_slice($argv, 1));
package main

import (
	"fmt"
	"os"

	openapiutil "github.com/alibabacloud-go/darabonba-openapi/v2/utils"
	dm "github.com/alibabacloud-go/dm-20151123/v2/client"
	"github.com/alibabacloud-go/tea/dara"
	"github.com/aliyun/credentials-go/credentials"
)

// 説明:
//
// 認証情報を使用してアカウントクライアントを初期化します。
//
// @return クライアント
//
// @throws Exception
func CreateClient() (_result *dm.Client, _err error) {
	config := new(credentials.Config).
		SetType("access_key").
		SetAccessKeyId("xxxxxx").
		SetAccessKeySecret("xxxxxx")

	akCredential, err := credentials.NewCredential(config)
	if err != nil {
		return _result, err
	}

	openapiConfig := &openapiutil.Config{
		Credential: akCredential,
	}
	// エンドポイントの詳細については、https://api.alibabacloud.com/product/Dm をご参照ください。
	openapiConfig.Endpoint = dara.String("dm.ap-southeast-1.aliyuncs.com")
	_result, _err = dm.NewClient(openapiConfig)
	return _result, _err
}

func main() {
	err := _main(dara.StringSlice(os.Args[1:]))
	if err != nil {
		panic(err)
	}
}

func _main(args []*string) (_err error) {
	client, _err := CreateClient()
	if _err != nil {
		return _err
	}

	// 添付ファイルを作成します。
	attachments, _err := getAttachments()
	if _err != nil {
		return _err
	}

	// SingleSendMailRequest の代わりに SingleSendMailAdvanceRequest を使用します。
	singleSendMailRequest := &dm.SingleSendMailAdvanceRequest{
		AccountName:    dara.String("sender@example.com"),
		AddressType:    dara.Int32(1),
		ReplyToAddress: dara.Bool(true),
		ToAddress:      dara.String("recipient@example.com"),
		Subject:        dara.String("Subject"),
		HtmlBody:       dara.String("Email Body"),
		Attachments:    attachments,
	}

	runtime := &dara.RuntimeOptions{}
	// SingleSendMailWithOptions の代わりに SingleSendMailAdvance メソッドを使用します。
	resp, _err := client.SingleSendMailAdvance(singleSendMailRequest, runtime)
	if _err != nil {
		fmt.Printf("[ERROR] %s\n", _err.Error())
		return _err
	}

	fmt.Printf("[LOG] %s\n", dara.Stringify(resp))
	return _err
}

// getAttachments は添付ファイルリストを取得します。
func getAttachments() ([]*dm.SingleSendMailAdvanceRequestAttachments, error) {
	// 注: ファイルパスを実際のファイルパスに変更する必要があります。
	attach1, err := createAttachmentFromFile("test1.txt", `C:\Users\Downloads\111.txt`)
	if err != nil {
		return nil, fmt.Errorf("Failed to create attachment test1.txt: %v", err)
	}

	attach2, err := createAttachmentFromFile("test2.txt", `C:\Users\Downloads\222.txt`)
	if err != nil {
		return nil, fmt.Errorf("Failed to create attachment test2.txt: %v", err)
	}

	return []*dm.SingleSendMailAdvanceRequestAttachments{attach1, attach2}, nil
}

// createAttachmentFromFile はファイルから添付ファイルを作成します。
func createAttachmentFromFile(name, filePath string) (*dm.SingleSendMailAdvanceRequestAttachments, error) {
	// ファイルを開きます。
	file, err := os.Open(filePath)
	if err != nil {
		return nil, fmt.Errorf("Cannot open file %s: %v", filePath, err)
	}

	// ファイル情報を取得します。
	fileInfo, err := file.Stat()
	if err != nil {
		file.Close()
		return nil, fmt.Errorf("Cannot get file information %s: %v", filePath, err)
	}

	// ファイルサイズを確認します。
	// if fileInfo.Size() > 15*1024*1024 {
	// 	file.Close()
	// 	return nil, fmt.Errorf("File %s exceeds the size limit", filePath)
	// }

	// 添付ファイルオブジェクトを作成し、ファイルを io.Reader として使用します。
	attachment := &dm.SingleSendMailAdvanceRequestAttachments{
		AttachmentName:      dara.String(name),
		AttachmentUrlObject: file, // ファイルを直接 io.Reader として使用します。
	}

	fmt.Printf("Attachment %s created. Size: %d bytes\n", name, fileInfo.Size())

	// 注: 実際のアプリケーションでは、送信が完了するまでファイルを開いたままにするか、ファイルハンドル関連の問題を避けるためにファイルの内容をメモリに読み込む必要がある場合があります。

	return attachment, nil
}
説明

OpenAPI Explorer に移動して、添付ファイルを処理するメソッドを含む最新のソフトウェア開発キット (SDK) パッケージをダウンロードしてください。

VPC 内の ECS インスタンスを使用し、内部ネットワーク接続が必要な場合は、config.setEndpointType("internal"); パラメーターを設定します。

API 呼び出しの説明

次の例では Python を使用します:

基本的なロジックは、ファイルのバイナリストリームを読み取り、複数の添付ファイルをリストにカプセル化し、そのリストを添付ファイルフィールドに渡すことです。次に、single_send_mail_advance 操作を呼び出してメールを送信します。このメソッドは singleSendMailWithOptions 操作とは異なることに注意してください。

  • SingleSendMailAdvanceRequestAttachments

このクラスは、ファイル名とコンテンツ (バイナリストリーム) を含むメールの添付ファイルを定義します。

  • SingleSendMailAdvanceRequest

このクラスは、送信者、受信者、件名、本文、添付ファイルなど、メールの送信に必要なすべてのパラメーターをカプセル化します。

  • single_send_mail_advance は 1 通のメールを送信します。

Dm20151123Client インスタンスからこのメソッドを呼び出して、添付ファイル付きのメールを送信できます。

結果

トラブルシューティングセンターを使用してリクエスト ID をクエリし、パラメーターが正しく渡されたことを確認できます。

image

エラーメッセージ: code: 400, The attachment url is invalid

添付ファイルのパスとリージョンの値が正しいことを確認してください。また、添付ファイルをサポートするメソッドを使用していることを確認してください。たとえば、Python では、single_send_mail_with_options の代わりに single_send_mail_advance を使用します。

config.endpoint = "dm.ap-southeast-1.aliyuncs.com";

config.regionId = "ap-southeast-1";

説明

エンドポイントとリージョン ID を、お使いのリージョンに対応する値に置き換えてください。