sendgrid4j

インデックスに戻る link to github

概要

sendgrid4jはJavaで実装されたSendGridのWebAPIのラッパーです。

以下の機能がサポートされています。

  • メール送信(WebAPI)
    • 複数の添付ファイルを添付可能
    • カテゴリの設定
  • Email Reportsの取得
    • Bounces
    • Blocks
    • Spam reports
    • Invalid emails
    • Unsubscribes
  • Statisticsの取得
  • アプリケーション設定
    • AddressWhiteList
    • Bcc
    • その他

使い方

JavaDoc

それぞれのクラスはSendGridのリクエストパラメータ、またはレスポンスJSONのシンプルなラッパーです。

各クラスのプロパティの詳細についてはSendGridのAPIドキュメントをご確認ください。

http://sendgrid.com/docs/API_Reference/Web_API/index.html

すべてのメソッドはSendGridClientから実行されます。SendGridClient.javaのソースコードを見ることでできることが何かはだいたいわかると思います。


サンプル

メール送信

    SendGridClient client = new SendGridClient(USERNAME, PASSWORD);
    WebMail mail = new WebMail();
    //Set from and to information
    mail.setFrom("test@flect.co.jp");
    mail.setTo("test@flect.co.jp");
    mail.setFromName("test");
    mail.setToName("test");
    
    //Subject and text(or You can use setHtml)
    mail.setSubject("Test - " + new Date());
    mail.setText("This is a test mail");
    
    //Category(X-SMTPAPI option)
    mail.setCategory("test");
    
    client.mail(mail);

Bounce一覧の取得

    SendGridClient client = new SendGridClient(USERNAME, PASSWORD);
    
    Bounce.Get request = new Bounce.Get();
    request.setDays(7);
    List list = client.getBounces(request);
    for (Bounce bounce : list) {
        System.out.println(bounce.getEmail());
    }

Statisticsの取得

    SendGridClient client = new SendGridClient(USERNAME, PASSWORD);
    Statistic.Get request = new Statistic.Get();
    //request.setCategory("test");
    request.setDays(10);
    List list = client.getStatistics(request);
    for (Statistic stat : list) {
        System.out.println("Statistics: " + 
            stat.getDate() + ", " +
            "Category = " + stat.getCategory() + ", " +
            "Requests = " + stat.getRequests() + ", " +
            "Bounces = " + stat.getBounces() + ", " +
            "Clicks = " + stat.getClicks() + ", " +
            "Opens = " + stat.getOpens() + ", " +
            "SpamReports = " + stat.getSpamReports() + ", " +
            "UniqueClicks = " + stat.getUniqueClicks() + ", " +
            "UniqueOpens = " + stat.getUniqueOpens() + ", " +
            "Blocked = " + stat.getBlocked() + ", " +
            "Delivered = " + stat.getDelivered() + ", " +
            "Unsubscribes = " + stat.getUnsubscribes() + ", " +
            "InvalidEmails = " + stat.getInvalidEmails() + ", " +
            "RepeatUnsubscribes = " + stat.getRepeatUnsubscribes() + ", " +
            "SpamDrops = " + stat.getSpamDrops() + ", " +
            "RepeatBounces = " + stat.getRepeatBounces() + ", " +
            "RepeatSpamReports = " + stat.getRepeatSpamReports() + ", " +
            "");
    }

最新版

ダウンロード - 0.9.2

Maven

    <repositories>
        <repository>
            <id>jp.co.flect</id>
            <name>FLECT maven repository</name>
            <url>http://flect.github.io/maven-repo/</url>
        </repository>
    </repositories>

    <dependencies>
        <dependency>
            <groupId>jp.co.flect</groupId>
            <artifactId>sendgrid4j</artifactId>
            <version>0.9.2</version>
        </dependency>
    </dependencies>

ライセンス

MIT