第3回：SOAPを利用したWeb API (2/2)

PerlでWeb APIを使いたおす

第３回：SOAPを利用したWeb API
著者：水野貴明 2006/10/3

SOAPをPerlから使う

それでは、実際にSOAPを利用したWeb APIにPerlを使ってアクセスしてみることにしましょう。今回サンプルとして利用するのは、Google SOAP Search API（注1）、つまりGoogleが公開している検索用APIです。このサービスは公開されてからかなりの時間がたっているのですがいまだにベータ版で、検索の回数が1つのライセンスキーに対して1日1000クエリに限定されています。実用的かというと疑問が残りますが、有名なサービスということで、サンプルにはよいでしょう。

注1： http://www.google.com/apis/

リスト15に作成したサンプルを示します。このサンプルでは、「perl」というキーワードで検索を行い、10件のURLを表示しています。なお、このサンプルを実行するには、あらかじめGoogleのWebサイトにアクセスして、ライセンスキーを取得する必要があります。

リスト15：Google SOAP Search APIのサンプル


		#!/usr/bin/perl

		use SOAP::Lite;

		use strict;

		use warnings;

		

		my $license_key ='ライセンスキー';

		my $wsdl        = 'file:GoogleSearch.wsdl';

		my $word        = 'perl';

		my $api    = SOAP::Lite->service($wsdl);

		my $result = $api->doGoogleSearch(

		    $license_key,

		    $word,

		    0,

		    10,

		    'False',

		    '',

		    'False',

		    '',

		    'UTF-8',

		    'UTF-8',

		);

		foreach (@{$result->{resultElements}}){

		    print $_->{URL}."\n";

		}

Google SOAP Search APIは、WSDLを公開しているので、それをサンプルと同じディレクトリに置いて実行してください。WSDLのおかげで、プログラム中ではアクセス先のURLも、アクセスしているメソッドの詳細も記述する必要がありません。

アクセスするのはWeb検索を行うdoGoogleSearchというメソッドです。受け渡すパラメータは次ページの表3の10個です。

パラメータ	意味
key	Google API Key
q	検索する文字列
start	取得する結果のスタート位置（一番初めからなら0）
maxResult	取得する結果の件数
filter	フィルタを設定する。同じサイトからの結果をひとつにするなどの設定が可能。
restricts	検索する対象を限定する。日本のサイトに限定するなら「countryJP」。
safeSearch	Safe Search（アダルトサイトを検索しない機能）を有効にする
lr	検索対象とする言語（日本語ならlang_ja）
ie	検索する文字列の文字コード
oe	返ってくるデータの文字コード

表3：doGoogleSearchのパラメータ

結果はパラメータ名をキーとしたハッシュとして返ってきます。検索されたページのデータはresultElementsというパラメータなので、それをループで回して、URLを表示しています。

SOAP::Liteは処理を全て自動的に行ってくれるので非常に便利なのですが、内部で何が起こっているのかがよくわかりません。そこで、use文において以下のようにデバッグ情報を表示する設定を行うことで、どういう情報がやり取りされているのかを知ることができます。


		use SOAP::Lite +trace => [qw(debug)];

前のページ 1 2

著者プロフィール
水野貴明
1973年東京生まれ。エンジニア兼技術系ライター。株式会社はてな勤務。近著に「俺流Amazonの作り方」（アスキー）、「詳解RSS〜RSSを利用したサービスの理論と実践」（ディー・アート）など。趣味はラテン音楽と海外旅行と神輿。現在、家を荒らしまわるネズミの被害に頭を悩ませている。

INDEX
第3回：SOAPを利用したWeb API
	SOAPの仕組み
	SOAPをPerlから使う

PerlでWeb APIを使いたおす
第1回	Web APIの紹介
第2回	XML-RPCを利用したWeb API
第3回	SOAPを利用したWeb API
第4回	アーキテクチャスタイル「REST」とは何か
第5回	AtomPP を利用したWeb API
第6回	JSONとYAML

人気記事ランキング

人気コーナーランキング

タイプ

連載

特集

人気記事トップ10

新着記事

企画広告も役立つ情報バッチリ！ Sponsored