Google Web API をコールするクライアントを作る

googleapi/
        dotnet/                       .NET のサンプル (C# と Visual Basic)
        javadoc/                      googleapi.jar の JavaDoc
        licenses/                     googleapi.jar で使用しているライブラリのライセンス
        soap-samples/                 Google Web API の SOAP メッセージとレスポンスのサンプル
        APIs_Reference.html           Google Web API のリファレンスマニュアル
        googleapi.jar                 Java のライブラリ
        GoogleAPIDemo.java            Java のサンプル
        GoogleSearch.wsdl             Google Web API の WSDL
        LICENSE.txt                   Google Web API のライセンス
        README.txt                    README

java -cp googleapi.jar com.google.soap.search.GoogleAPIDemo <ライセンスキー> <処理> <処理の引数>
        処理       search, cached, spell
        処理の引数  search   検索する文字列  複数の文字列の場合は "" で囲む
                   caced    URL
                   spell    スペルチェックする文字列  複数の文字列の場合は "" で囲む

    String clientKey = args[0];
    String directive = args[1];
    String directiveArg = args[2];
 
    GoogleSearch s = new GoogleSearch();               // GoogleSearch オブジェクトの生成
    s.setKey(clientKey);                               // ライセンスキーをセット
 
    try {
        if (directive.equalsIgnoreCase("search")) {
            s.setQueryString(directiveArg);            // 検索実行
            GoogleSearchResult r = s.doSearch();
            System.out.println("Google Search Results:");
            System.out.println("======================");
            System.out.println(r.toString());          // 結果の表示
        }
    } catch (GoogleSearchFault f) {
        System.out.println("The call to the Google Web APIs failed:");
        System.out.println(f.toString());
    }

<?xml version="1.0" encoding="UTF-8"?>
<configuration 
       xmlns="http://java.sun.com/xml/ns/jax-rpc/ri/config">
  <wsdl location="GoogleSearch.wsdl"
       packageName="google.webapi"/>
</configuration>

      <xsd:complexType name="DirectoryCategory">
        <xsd:all>
          <xsd:element name="fullViewableName" type="xsd:string"/>
          <xsd:element name="specialEncoding" type="xsd:string"/>
        </xsd:all>
      </xsd:complexType>

public class DirectoryCategory {
    protected java.lang.String fullViewableName;
    protected java.lang.String specialEncoding;
    
    public DirectoryCategory() {
    }
    
    public DirectoryCategory(java.lang.String fullViewableName,
                             java.lang.String specialEncoding) {
        this.fullViewableName = fullViewableName;
        this.specialEncoding = specialEncoding;
    }
    
    public java.lang.String getFullViewableName() {
        return fullViewableName;
    }
    
    public void setFullViewableName(java.lang.String fullViewableName) {
        this.fullViewableName = fullViewableName;
    }
    
    public java.lang.String getSpecialEncoding() {
        return specialEncoding;
    }
    
    public void setSpecialEncoding(java.lang.String specialEncoding) {
        this.specialEncoding = specialEncoding;
    }
}

import java.rmi.RemoteException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
 
import google.webapi.*;
 
public class GoogleSearch {
    private GoogleSearchPort port;
 
    public static final int MAX = 100;
    public static final int MIN = 10;
 
    public GoogleSearch() {
        // 手順 1 サービスのインスタンスの生成
        GoogleSearchService service = new GoogleSearchService_Impl();
 
        // 手順 2 スタブの取得
        port = (GoogleSearchPort)service.getGoogleSearchPort();
    }
 
    public GoogleSearchResult search(String keyword, int start) throws RemoteException {
        return search(keyword, start, MAX);
    }
 
    public GoogleSearchResult search(String keyword, int start, int max) throws RemoteException {
        // 最大件数が MAX 以上だったら MAX に、MIN 以下であれば MIN にする
        if (max > MAX) {
            max = MAX;
        } else if (max < MIN) {
            max = MIN;
        }
 
        // 手順 3 Web サービスで定義されたメソッドのコール
        // 手順 4 戻り値の受け取り。
        GoogleSearchResult result
            = port.doGoogleSearch("XXXXXXXXXXXXXXXXXXXX", // java.lang.String key
                                  keyword, //java.lang.String q
                                  start, // int start
                                  10, // int maxResults
                                  false, //boolean filter
                                  "", // java.lang.String restrict        
                                  false, //boolean safeSearch                
                                  "lang_ja|lang_en", // java.lang.String lr
                                  "UTF-8", // java.lang.String ie
                                  "UTF-8"); // java.lang.String oe
        
        double time = result.getSearchTime();
        int count = result.getEstimatedTotalResultsCount();
        count -= start;
 

        // 検索結果の件数が 10 件以上で、表示する最大が 10 以上であれば
        // 再検索を行い、結果をマージする
        if (count > 0 && max > 10) {
            max = (count > max) ? max : count;
 
            // ResultElement を保持させるためのリスト
            List elements = new ArrayList();
            elements.add(result.getResultElements());
 
            for (int i = 10; i < max; i += 10) {
                int m = (i + 10 < max) ? 10 : max - i;
 
                // 再検索
                GoogleSearchResult tmpResult
                    = port.doGoogleSearch("XXXXXXXXXXXXXXXXXXXX", 
                                          keyword, start + i, m,
                                          false, "", false, "lang_ja|lang_en",
                                          "UTF-8", "UTF-8");
                
                // 検索結果をリストに追加
                elements.add(tmpResult.getResultElements());
                time += tmpResult.getSearchTime();
            }
             
            // 検索でヒットしたページの総数を調べる
            int number = 0;
            for (int i = 0; i < elements.size(); i++) {
                number += ((ResultElement[])elements.get(i)).length;
            }
 
            // 配列にまとめて、result にセットする
            ResultElement[] resultElements = new ResultElement[number];
            number = 0;
            for (int i = 0; i < elements.size(); i++) {
                int length = ((ResultElement[])elements.get(i)).length;
                System.arraycopy((ResultElement[])elements.get(i), 0,
                                 resultElements, number, length);
                number += length;
            }
 
            result.setEndIndex(start + number);
            result.setSearchTime(time);
            result.setResultElements(resultElements);
        }

        
        return result;
    }
}

    // HTML 表示のために JEditorPane を生成
    private JEditorPane makeResultPane(ResultElement[] elements) {
        JEditorPane pane = new JEditorPane("text/html", makeResultText());
        pane.setEditable(false);
 
        // ハイパーリンクの設定
        pane.addHyperlinkListener(new HyperlinkListener() {
                public void hyperlinkUpdate(HyperlinkEvent event) {
                    if (event.getEventType() == HyperlinkEvent.EventType.ACTIVATED) {
                        hyperlinkActivated(event.getURL());
                    }
                }
            });

        return pane;
    }
 
    // 検索でヒットしたページの情報を HTML で表記する
    private String makeResultText(ResultElement[] elements) {
        StringBuffer buffer = new StringBuffer();

        for (int i = 0 ; i < elements.length ; i++) {
            buffer.append("<p><a href=\"");
            buffer.append(elements[i].getURL());
            buffer.append("\">");
            buffer.append(elements[i].getTitle());
            buffer.sppend("</a><br>");
            buffer.append(elements[i].getSnippet());
            buffer.append("<br><font color=#008000>");
            buffer.append(elements[i].getURL());
            buffer.append(" - ");
            buffer.append(elements[i].getCachedSize());
            buffer.append("</font></p>");
        }
 
        return buffer.toString();
    }
 
    // ハイパーリンクがクリックされたときの処理
    // 簡易ブラウザーを立ち上げる
    private void hyperlinkActivated(URL url) {
        new SimpleBrowser(frame, url).show();
    }

    private JComboBox dateBox;
    private static final String[] dates = {"今日の", "今週の", "今月の", "3ヶ月間の", "半年の", "今年の"};
    private static final long[] diffs = {1, 7, 31, 93, 186, 365};
    private static final String DATERANGE = " daterange:";
 
    public TodaysGoogle() {
        frame.setTitle("Today's Google");

        // コンボボックスの追加        
        dateBox = new JComboBox(dates);
        dateBox.setEditable(false);
        frame.getContentPane().add(dateBox, BorderLayout.WEST);
    }
 
    private String calculateJulianDate(String keyword) {
        long now = System.currentTimeMillis();
 
        // 1 日は 86400000 ミリ秒
        // 1970.1.1 はユリウス日では 2440588
        long today = now / 86400000 + 2440588;
 
        long diff = diffs[dateBox.getSelectedIndex()];
 
        return keyword + DATERANGE + (today - diff) + "-" + today;
    }

import java.io.RandomAccessFile;
import java.io.IOException;
import java.rmi.RemoteException;
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.StringTokenizer;
 
import google.webapi.*;
 
public class GoogleLinkChecker {
    private GoogleSearch searcher;
 
    public GoogleLinkChecker(String url, String filename) {
        searcher = new GoogleSearch();
 
        try {
            // 引数で指定された URL に対するリンクがあるかを調べる
            GoogleSearchResult result = searcher.search("link:" + url, 0, 10);
            save(filename, result.getEstimatedTotalResultsCount());
        } catch (RemoteException ex) {
            ex.printStackTrace();
        }
    }
 
    private void save(String filename, int count) {
        try {
            RandomAccessFile file = new RandomAccessFile(filename, "rw");
            String lastLine = null;
            while (true) {
                String str = file.readLine();
                if (str == null) {
                    break;
                } else {
                    lastLine = str;
                }
            }
 
            int lattestCount = 0;
            if (lastLine != null) {
                StringTokenizer tok = new StringTokenizer(lastLine, ",");
                String num = tok.nextToken();
                num = tok.nextToken().trim();
 
                lattestCount = Integer.parseInt(num);
            }
 
            DateFormat format = new SimpleDateFormat("yyyy/MM/dd");
            file.writeBytes(format.format(new Date()) + ", "
                            + count + ", " + (count - lattestCount) + "\n");
            file.close();
        } catch (IOException ex) {
            ex.printStackTrace();
        }
    }
 
    public static void main(String[] args) {
        if (args.length < 2) {
            System.err.println("Usage:");
            System.err.println("    java GoogleLinkChecker [URL] [csv file]");
            return;
        }
 
        new GoogleLinkChecker(args[0], args[1]);
    }
}

2003/01/01, 3, 3
2003/02/01, 5, 2
2003/03/01, 5, 0
2003/04/01, 15, 10
2003/05/01, 23, 8
2003/06/01, 20, -3

コラム AmazonのWebサービス

検索の雄がGoogleだとすれば、ショッピングサイトの雄はAmazonでしょう。そのAmazonもWebサービスを公開しており、Amazonが販売している商品の検索などを行うことができます。また、アメリカだけでなく日本、イギリス、ドイツのAmazonでもWebサービスを公開しています。もちろん、日本で売られているものを検索することもできます。

さらに特徴的なのはAmazonが行っているアソシエイト・プログラムとWebサービスを連動させることができるということです。アソシエイト・プログラムはAmazonが提供している紹介プログラムで、Amazonの商品の紹介を行うことで紹介料をもらえることができます。AmazonのWebサービスを利用したアプリケーションを公開することで、もしかしたらお小遣いまでもらえるかもしれません。

Amazon Webサービス
http://www.amazon.co.jp/exec/obidos/subst/associates/join/webservices.html

Amazon アソシエイト・プログラム
http://www.amazon.co.jp/exec/obidos/subst/associates/join/associates.html

AmazonのWebサービスを利用するにも登録(無料)が必要です。また、Googleと同じようにSDKもダウンロードすることができます。WSDLファイルは次のURLで公開されています。

http://soap.amazon.com/schemas3/AmazonWebServices.wsdl

Amazonでは多様な検索サービスを公開しています。たとえば、次に示すような検索を提供しています。

• キーワード
• 著者
• ISBN
• 俳優/監督
• アーティスト
• 製造業者
• ウィッシュリスト

また、アメリカのAmazonではショッピングカートへの商品の追加や削除なども行うことができます。

AmazonのWebサービスはREST^(注)とSOAPという2種類の方法で提供されています。RESTを使用した場合、CGIを利用して検索を行い、検索結果をXMLのドキュメントとして受け取ります。XSLTを使用することも可能です。

SOAPを使用した場合、クライアントの作成は基本的にGoogle Web APIと同様です。WSDLからスタブを作成し、スタブを利用してサービスを実行します。たとえば、キーワード検索はkeywordSearchRequestメソッドになり、引数がKeywordRequestクラス、戻り値がProductInfoクラスになります。

リスト10にキーワード検索を行うリストを示しました。

KeywordRequestクラスのコンストラクタで、検索に必要な条件を設定します。ここでは和書、結果の順序がセールスランクに指定しました。アソシエイト・プログラムに参加されている方はwebservices-20の部分をアソシエイトIDに変更します。

検索結果として検索件数、ページ数、タイトルを表示しています。

AmazonのWebサービスを使えば、Amazonを利用したセレクトショップを作ることなどが可能です。

(注) REST Representational State Transfer
http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm

    public void search(String keyword) {
        AmazonSearchService service = new AmazonSearchService_Impl();
        AmazonSearchPort port = (AmazonSearchPort)service.getAmazonSearchPort();
 
        KeywordRequest request = new KeywordRequest(
            keyword,          // キーワード
            "1",              // 結果のページ
            "books-jp",       // 検索するカテゴリ books-jp は和書
            "webservices-20", // アソシエイトID なければ webservices-20
            "lite",           // 結果の形式 lite or heavy
            "XXXXXXXXXXXXXX", // デベロッパID
            "+salesrank",     // 結果の並び順
            "jp",             // ロケール
            ""                // 価格の指定
        );
        
        try {
            ProductInfo info 
                = port.keywordSearchRequest(request);
        
            System.out.println("Total Results: " + info.getTotalResults());
            System.out.println("Total Pages: " + info.getTotalPages());
            System.out.println();
        
            Details[] details = info.getDetails();
            for (int i = 0; i < details.length; i++) {
                System.out.println("Title: " + details[i].getProductName());
            }
        } catch (RemoteException ex) {
            ex.printStackTrace();
        }
    }