repo_zf1Php7/documentation/manual/ja/module_specs/Zend_Service_Technorati.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 15617 -->
<sect1 id="zend.service.technorati">
    <title>Zend_Service_Technorati</title>

    <sect2 id="zend.service.technorati.introduction">
        <title>導入</title>
        <para>
            <classname>Zend_Service_Technorati</classname> は、Technorati API
            を使うための簡単で直感的なオブジェクト指向インターフェイスを提供します。
            利用可能なすべての
            <ulink url="http://technorati.com/developers/api/">Technorati API クエリ</ulink>
            にアクセスすることができ、API が返す XML
            形式のレスポンスを PHP で扱いやすいオブジェクトで返します。
        </para>
        <para>
            <ulink url="http://technorati.com/">Technorati</ulink>
            は、人気のあるブログ検索エンジンのひとつです。その API を使用すると、
            特定のブログについての情報を取得したり、
            指定したタグやフレーズにマッチするブログの著者の情報を取得したりできます。
            使用できるクエリの一覧は、
            <ulink url="http://technorati.com/developers/api/">Technorati API ドキュメント</ulink>
            あるいはこのドキュメントの
            <link linkend="zend.service.technorati.queries">使用できる Technorati クエリ</link>
            を参照ください。
        </para>
    </sect2>

    <sect2 id="zend.service.technorati.getting-started">
        <title>さあ始めましょう</title>
        <para>
            Technorati API を使用するには、キーが必要です。
            API キーを取得するには、まず最初に
            <ulink url="http://technorati.com/signup/">Technorati アカウントを作成</ulink>
            し、それから
            <ulink url="http://technorati.com/developers/apikey.html">API キーのセクション</ulink>
            に行ってください。
        </para>
        <note>
            <title>API キーの制限</title>
            <para>
                一日あたり最大 500 までの Technorati API コールを無料で行うことができます。
                現在の Technorati API のライセンスによってはその他の使用制限が適用されるかもしれません。
            </para>
        </note>
        <para>
            API キーを取得したら、いよいよ <classname>Zend_Service_Technorati</classname>
            を使うことができます。
        </para>
    </sect2>

    <sect2 id="zend.service.technorati.making-first-query">
        <title>はじめてのクエリ</title>
        <para>
            クエリを実行するにはまず最初に API キーを使用して
            <classname>Zend_Service_Technorati</classname> のインスタンスを作成します。
            そしてクエリの形式を選択し、引数を指定したうえでそれをコールします。
        </para>
        <example id="zend.service.technorati.making-first-query.example-1">
            <title>はじめてのクエリの実行</title>
            <programlisting language="php"><![CDATA[
// API_KEY を指定して
// Zend_Service_Technorati を作成します
$technorati = new Zend_Service_Technorati('VALID_API_KEY');

// Technorati で PHP というキーワードを検索します
$resultSet = $technorati->search('PHP');
]]></programlisting>
        </example>
        <para>
            検索用のメソッドにはオプションパラメータの配列を渡すことができます。
            これを使用すると、クエリをさらに絞り込むことができます。
        </para>
        <example id="zend.service.technorati.making-first-query.example-2">
            <title>クエリの精度の向上</title>
            <programlisting language="php"><![CDATA[
// API_KEY を指定して
// Zend_Service_Technorati を作成します
$technorati = new Zend_Service_Technorati('VALID_API_KEY');

// クエリをフィルタリングし、あまり影響力のない
// (あまり他からリンクされていない) ブログを結果から除外します
$options = array('authority' => 'a4');

// Technorati で PHP というキーワードを検索します
$resultSet = $technorati->search('PHP', $options);
]]></programlisting>
        </example>
        <para>
            <classname>Zend_Service_Technorati</classname> のインスタンスは使い捨てのオブジェクトではありません。
            したがって、クエリをコールするたびに毎回新たなインスタンスを作成するなどということは不要です。
            一度作成した <classname>Zend_Service_Technorati</classname>
            オブジェクトを、気の済むまで使い回せばいいのです。
        </para>
        <example id="zend.service.technorati.making-first-query.example-3">
            <title>ひとつの Zend_Service_Technorati インスタンスでの複数のクエリの送信</title>
            <programlisting language="php"><![CDATA[
// API_KEY を指定して
// Zend_Service_Technorati を作成します
$technorati = new Zend_Service_Technorati('VALID_API_KEY');

// Technorati で PHP というキーワードを検索します
$search = $technorati->search('PHP');

// Technorati で一番よく登録されているタブを取得します
$topTags = $technorati->topTags();
]]></programlisting>
        </example>
    </sect2>

    <sect2 id="zend.service.technorati.consuming-results">
        <title>結果の取得</title>
        <para>
            クエリの結果は、二種類の結果オブジェクトのうちのいずれかの形式で取得することができます。
        </para>
        <para>
            まず最初の形式は <classname>Zend_Service_Technorati_*ResultSet</classname>
            オブジェクトで表されるものです。結果セットオブジェクトは、
            基本的には結果オブジェクトのコレクションとなります。これは基底クラス
            <classname>Zend_Service_Technorati_ResultSet</classname> を継承したもので、
            PHP の <code>SeekableIterator</code> インターフェイスを実装しています。
            この結果セットを使用するいちばんよい方法は、PHP の <code>foreach</code>
            文を用いてループ処理することです。
        </para>
        <example id="zend.service.technorati.consuming-results.example-1">
            <title>結果セットオブジェクトの取得</title>
            <programlisting language="php"><![CDATA[
// API_KEY を指定して
// Zend_Service_Technorati を作成します
$technorati = new Zend_Service_Technorati('VALID_API_KEY');

// Technorati で PHP というキーワードを検索します
// $resultSet は Zend_Service_Technorati_SearchResultSet のインスタンスです
$resultSet = $technorati->search('PHP');

// 結果オブジェクトをループします
foreach ($resultSet as $result) {
    // $result は Zend_Service_Technorati_SearchResult のインスタンスです
}
]]></programlisting>
        </example>
        <para>
            <classname>Zend_Service_Technorati_ResultSet</classname> は <code>SeekableIterator</code>
            インターフェイスを実装しているので、結果コレクション内での位置を指定して
            特定の結果オブジェクトを取得することもできます。
        </para>
        <example id="zend.service.technorati.consuming-results.example-2">
            <title>特定の結果セットオブジェクトの取得</title>
            <programlisting language="php"><![CDATA[
// API_KEY を指定して
// Zend_Service_Technorati を作成します
$technorati = new Zend_Service_Technorati('VALID_API_KEY');

// Technorati で PHP というキーワードを検索します
// $resultSet は Zend_Service_Technorati_SearchResultSet のインスタンスです
$resultSet = $technorati->search('PHP');

// $result は Zend_Service_Technorati_SearchResult のインスタンスです
$resultSet->seek(1);
$result = $resultSet->current();
]]></programlisting>
        </example>
        <note>
            <para>
                <code>SeekableIterator</code> は配列として動作し、
                そのインデックスは 0 から始まります。インデックス 1
                を指定すると、コレクション内の 2 番目の結果を取得することになります。
            </para>
        </note>
        <para>
            2 番目の形式は、単体の特別な結果オブジェクトで表されるものです。
            <classname>Zend_Service_Technorati_GetInfoResult</classname>、<classname>Zend_Service_Technorati_BlogInfoResult</classname>
            および <classname>Zend_Service_Technorati_KeyInfoResult</classname> は、
            <classname>Zend_Service_Technorati_Author</classname> や <classname>Zend_Service_Technorati_Weblog</classname>
            といったオブジェクトのラッパーとして働きます。
        </para>
        <example id="zend.service.technorati.consuming-results.example-3">
            <title>単体の結果オブジェクトの取得</title>
            <programlisting language="php"><![CDATA[
// API_KEY を指定して
// Zend_Service_Technorati を作成します
$technorati = new Zend_Service_Technorati('VALID_API_KEY');

// weppos についての情報を取得します
$result = $technorati->getInfo('weppos');

$author = $result->getAuthor();
echo '<h2>' . $author->getFirstName() . ' ' . $author->getLastName() .
     ' のブログ</h2>';
echo '<ol>';
foreach ($result->getWeblogs() as $weblog) {
    echo '<li>' . $weblog->getName() . '</li>';
}
echo "</ol>";
]]></programlisting>
        </example>
        <para>
            レスポンスクラスの詳細については
            <link linkend="zend.service.technorati.classes">Zend_Service_Technorati クラス</link>
            のセクションを参照ください。
        </para>

    </sect2>

    <sect2 id="zend.service.technorati.handling-errors">
        <title>エラー処理</title>
        <para>
            <classname>Zend_Service_Technorati</classname> のクエリメソッドは、失敗したときには
            <classname>Zend_Service_Technorati_Exception</classname> をスローします。
            またその際にはわかりやすいエラーメッセージを提供します。
        </para>
        <para>
            <classname>Zend_Service_Technorati</classname> のクエリが失敗する原因は、いくつか考えられます。
            <classname>Zend_Service_Technorati</classname> は、クエリを送信する際にすべてのパラメータを検証します。
            もし無効なパラメータや無効な値を指定していた場合は
            <classname>Zend_Service_Technorati_Exception</classname> をスローします。
            さらに、Technorati API が一時的に使用できなくなっていたり、
            そのレスポンスが整形式でない場合もあり得るでしょう。
        </para>
        <para>
            Technorati のクエリは、常に <code>try</code>...<code>catch</code>
            ブロック内に記述するようにしましょう。
        </para>
        <example id="zend.service.technorati.handling-errors.example-1">
            <title>クエリの例外処理</title>
            <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
try {
    $resultSet = $technorati->search('PHP');
} catch(Zend_Service_Technorati_Exception $e) {
    echo "エラーが発生しました: " $e->getMessage();
}
]]></programlisting>
        </example>
    </sect2>

    <sect2 id="zend.service.technorati.checking-api-daily-usage">
        <title>API キーの使用限度の確認</title>
        <para>
            今日は後何回 API キーが使えるのかを調べたいことも多々あるでしょう。
            デフォルトでは、Technorati の API は 1 日あたり 500 回までしか使用することができません。
            それを超えて使用しようとすると、<classname>Zend_Service_Technorati</classname>
            は例外を返します。自分の API キーの使用状況を取得するには
            <classname>Zend_Service_Technorati::keyInfo()</classname> メソッドを使用します。
        </para>
        <para>
            <classname>Zend_Service_Technorati::keyInfo()</classname> は
            <classname>Zend_Service_Technorati_KeyInfoResult</classname> オブジェクトを返します。
            詳細は
            <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
            を参照ください。
        </para>
        <example id="zend.service.technorati.checking-api-daily-usage.example-1">
            <title>API キーの使用状況の取得</title>
            <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$key = $technorati->keyInfo();

echo "API Key: " . $key->getApiKey() . "<br />";
echo "Daily Usage: " . $key->getApiQueries() . "/" .
     $key->getMaxQueries() . "<br />";
]]></programlisting>
        </example>
    </sect2>

    <sect2 id="zend.service.technorati.queries">
        <title>使用できる Technorati クエリ</title>
        <para>
            <classname>Zend_Service_Technorati</classname> は以下のクエリをサポートしています。
            <itemizedlist>
                <listitem><para><link linkend="zend.service.technorati.queries.cosmos"><code>Cosmos</code></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.queries.search"><code>Search</code></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.queries.tag"><code>Tag</code></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.queries.dailycounts"><code>DailyCounts</code></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.queries.toptags"><code>TopTags</code></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.queries.bloginfo"><code>BlogInfo</code></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.queries.blogposttags"><code>BlogPostTags</code></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.queries.getinfo"><code>GetInfo</code></link></para></listitem>
            </itemizedlist>
        </para>

        <sect3 id="zend.service.technorati.queries.cosmos">
            <title>Technorati Cosmos</title>
            <para>
                <ulink url="http://technorati.com/developers/api/cosmos.html">Cosmos</ulink>
                クエリは、指定した URL にリンクしているブログを探します。このクエリは
                <link linkend="zend.service.technorati.classes.cosmosresultset"><classname>Zend_Service_Technorati_CosmosResultSet</classname></link>
                オブジェクトを返します。詳細は
                <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
                の <classname>Zend_Service_Technorati::cosmos()</classname> を参照ください。
            </para>
            <example id="zend.service.technorati.queries.cosmos.example-1">
                <title>Cosmos クエリ</title>
                <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$resultSet = $technorati->cosmos('http://devzone.zend.com/');

echo "<p>Reading " . $resultSet->totalResults() .
     " of " . $resultSet->totalResultsAvailable() .
     " available results</p>";
echo "<ol>";
foreach ($resultSet as $result) {
    echo "<li>" . $result->getWeblog()->getName() . "</li>";
}
echo "</ol>";
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.queries.search">
            <title>Technorati Search</title>
            <para>
                <ulink url="http://technorati.com/developers/api/search.html">Search</ulink>
                クエリは、指定した検索文字列を含むブログを探します。このクエリは
                <link linkend="zend.service.technorati.classes.searchresultset"><classname>Zend_Service_Technorati_SearchResultSet</classname></link>
                オブジェクトを返します。詳細は
                <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
                の <classname>Zend_Service_Technorati::search()</classname> を参照ください。
            </para>
            <example id="zend.service.technorati.queries.search.example-1">
                <title>Search クエリ</title>
                <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$resultSet = $technorati->search('zend framework');

echo "<p>Reading " . $resultSet->totalResults() .
     " of " . $resultSet->totalResultsAvailable() .
     " available results</p>";
echo "<ol>";
foreach ($resultSet as $result) {
    echo "<li>" . $result->getWeblog()->getName() . "</li>";
}
echo "</ol>";
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.queries.tag">
            <title>Technorati Tag</title>
            <para>
                <ulink url="http://technorati.com/developers/api/tag.html">Tag</ulink>
                クエリは、指定したタグがつけられている投稿を探します。このクエリは
                <link linkend="zend.service.technorati.classes.tagresultset"><classname>Zend_Service_Technorati_TagResultSet</classname></link>
                オブジェクトを返します。詳細は
                <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
                の <classname>Zend_Service_Technorati::tag()</classname> を参照ください。
            </para>
            <example id="zend.service.technorati.queries.tag.example-1">
                <title>Tag クエリ</title>
                <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$resultSet = $technorati->tag('php');

echo "<p>Reading " . $resultSet->totalResults() .
     " of " . $resultSet->totalResultsAvailable() .
     " available results</p>";
echo "<ol>";
foreach ($resultSet as $result) {
    echo "<li>" . $result->getWeblog()->getName() . "</li>";
}
echo "</ol>";
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.queries.dailycounts">
            <title>Technorati DailyCounts</title>
            <para>
                <ulink url="http://technorati.com/developers/api/dailycounts.html">DailyCounts</ulink>
                クエリは、指定したキーワードを含む投稿の 1 日あたりの数を返します。このクエリは
                <link linkend="zend.service.technorati.classes.dailycountsresultset"><classname>Zend_Service_Technorati_DailyCountsResultSet</classname></link>
                オブジェクトを返します。詳細は
                <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
                の <classname>Zend_Service_Technorati::dailyCounts()</classname> を参照ください。
            </para>
            <example id="zend.service.technorati.queries.dailycounts.example-1">
                <title>DailyCounts クエリ</title>
                <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$resultSet = $technorati->dailyCounts('php');

foreach ($resultSet as $result) {
    echo "<li>" . $result->getDate() .
         "(" . $result->getCount() . ")</li>";
}
echo "</ol>";
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.queries.toptags">
            <title>Technorati TopTags</title>
            <para>
                <ulink url="http://technorati.com/developers/api/toptags.html">TopTags</ulink>
                クエリは、Technorati にもっとも多く登録されているタグの情報を返します。このクエリは
                <link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
                オブジェクトを返します。詳細は
                <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
                の <classname>Zend_Service_Technorati::topTags()</classname> を参照ください。
            </para>
            <example id="zend.service.technorati.queries.toptags.example-1">
                <title>TopTags タグ</title>
                <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$resultSet = $technorati->topTags();

echo "<p>Reading " . $resultSet->totalResults() .
     " of " . $resultSet->totalResultsAvailable() .
     " available results</p>";
echo "<ol>";
foreach ($resultSet as $result) {
    echo "<li>" . $result->getTag() . "</li>";
}
echo "</ol>";
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.queries.bloginfo">
            <title>Technorati BlogInfo</title>
            <para>
                <ulink url="http://technorati.com/developers/api/bloginfo.html">BlogInfo</ulink>
                は、指定した URL に関連するブログの情報を返します。このクエリは
                <link linkend="zend.service.technorati.classes.bloginforesult"><classname>Zend_Service_Technorati_BlogInfoResult</classname></link>
                オブジェクトを返します。詳細は
                <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
                の <classname>Zend_Service_Technorati::blogInfo()</classname> を参照ください。
            </para>
            <example id="zend.service.technorati.queries.bloginfo.example-1">
                <title>BlogInfo クエリ</title>
                <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$result = $technorati->blogInfo('http://devzone.zend.com/');

echo '<h2><a href="' . (string) $result->getWeblog()->getUrl() . '">' .
     $result->getWeblog()->getName() . '</a></h2>';
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.queries.blogposttags">
            <title>Technorati BlogPostTags</title>
            <para>
                <ulink url="http://technorati.com/developers/api/blogposttags.html">BlogPostTags</ulink>
                クエリは、そのブログでよく使われているタグの情報を返します。このクエリは
                <link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
                オブジェクトを返します。詳細は
                <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
                の <classname>Zend_Service_Technorati::blogPostTags()</classname> を参照ください。
            </para>
            <example id="zend.service.technorati.queries.blogposttags.example-1">
                <title>BlogPostTags クエリ</title>
                <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$resultSet = $technorati->blogPostTags('http://devzone.zend.com/');

echo "<p>Reading " . $resultSet->totalResults() .
     " of " . $resultSet->totalResultsAvailable() .
     " available results</p>";
echo "<ol>";
foreach ($resultSet as $result) {
    echo "<li>" . $result->getTag() . "</li>";
}
echo "</ol>";
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.queries.getinfo">
            <title>Technorati GetInfo</title>
            <para>
                <ulink url="http://technorati.com/developers/api/getinfo.html">GetInfo</ulink>
                クエリは、あるメンバーについて Technorati が把握している情報を返します。このクエリは
                <link linkend="zend.service.technorati.classes.getinforesult"><classname>Zend_Service_Technorati_GetInfoResult</classname></link>
                オブジェクトを返します。詳細は
                <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
                の <classname>Zend_Service_Technorati::getInfo()</classname> を参照ください。
            </para>
            <example id="zend.service.technorati.queries.getinfo.example-1">
                <title>GetInfo クエリ</title>
                <programlisting language="php"><![CDATA[
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$result = $technorati->getInfo('weppos');

$author = $result->getAuthor();
echo "<h2>Blogs authored by " . $author->getFirstName() . " " .
     $author->getLastName() . "</h2>";
echo "<ol>";
foreach ($result->getWeblogs() as $weblog) {
    echo "<li>" . $weblog->getName() . "</li>";
}
echo "</ol>";
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.queries.keyinfo">
            <title>Technorati KeyInfo</title>
            <para>
               KeyInfo クエリは、API キーの使用状況についての情報を返します。このクエリは
               <link linkend="zend.service.technorati.classes.keyinforesult"><classname>Zend_Service_Technorati_KeyInfoResult</classname></link>
               オブジェクトを返します。詳細は
               <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
               の <classname>Zend_Service_Technorati::keyInfo()</classname> を参照ください。
            </para>
        </sect3>

    </sect2>

    <sect2 id="zend.service.technorati.classes">
        <title>Zend_Service_Technorati クラス</title>
        <para>
            以下のクラスは、Technorati の各種クエリから返されるものです。
            <classname>Zend_Service_Technorati_*ResultSet</classname> 系のクラスは、
            それぞれの形式にあわせた結果セットを保持します。
            その中身は形式にあわせた結果オブジェクトであり、容易に処理することができます。
            これらの結果セットクラスはすべて
            <classname>Zend_Service_Technorati_ResultSet</classname> クラスを継承しており、かつ
            <code>SeekableIterator</code> インターフェイスを実装しています。
            これによって、結果のループ処理や特定の結果の取り出しが簡単にできるようになります。
            <itemizedlist>
                <listitem><para><link linkend="zend.service.technorati.classes.resultset"><classname>Zend_Service_Technorati_ResultSet</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.cosmosresultset"><classname>Zend_Service_Technorati_CosmosResultSet</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.searchresultset"><classname>Zend_Service_Technorati_SearchResultSet</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.tagresultset"><classname>Zend_Service_Technorati_TagResultSet</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.dailycountsresultset"><classname>Zend_Service_Technorati_DailyCountsResultSet</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.result"><classname>Zend_Service_Technorati_Result</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.cosmosresult"><classname>Zend_Service_Technorati_CosmosResult</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.searchresult"><classname>Zend_Service_Technorati_SearchResult</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.tagresult"><classname>Zend_Service_Technorati_TagResult</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.dailycountsresult"><classname>Zend_Service_Technorati_DailyCountsResult</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.tagsresult"><classname>Zend_Service_Technorati_TagsResult</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.getinforesult"><classname>Zend_Service_Technorati_GetInfoResult</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.bloginforesult"><classname>Zend_Service_Technorati_BlogInfoResult</classname></link></para></listitem>
                <listitem><para><link linkend="zend.service.technorati.classes.keyinforesult"><classname>Zend_Service_Technorati_KeyInfoResult</classname></link></para></listitem>
            </itemizedlist>
        </para>
        <note>
            <para>
                <classname>Zend_Service_Technorati_GetInfoResult</classname>、
                <classname>Zend_Service_Technorati_BlogInfoResult</classname>
                そして <classname>Zend_Service_Technorati_KeyInfoResult</classname>
                には上にあげたクラスと異なる点があります。これらは結果セットに属しておらず、
                インターフェイスを実装していません。これらは単一のレスポンスオブジェクトを表し、
                <classname>Zend_Service_Technorati_Author</classname> や <classname>Zend_Service_Technorati_Weblog</classname>
                といった <classname>Zend_Service_Technorati</classname> のオブジェクトのラッパーとして働きます。
            </para>
        </note>
        <para>
            <classname>Zend_Service_Technorati</classname> には、これ以外にも
            特定のレスポンスオブジェクトを表す便利なクラスが含まれています。
            <classname>Zend_Service_Technorati_Author</classname> は、Technorati のアカウント
            (ブログの著者、いわゆるブロガー) を表します。
            <classname>Zend_Service_Technorati_Weblog</classname> は単一のウェブログオブジェクトを表します。
            ここには、フィードの URL やブログ名などの情報が含まれます。詳細は
            <ulink url="http://framework.zend.com/apidoc/core/">API リファレンスガイド</ulink>
            の <classname>Zend_Service_Technorati</classname> を参照ください。
        </para>

        <sect3 id="zend.service.technorati.classes.resultset">
            <title>Zend_Service_Technorati_ResultSet</title>
            <para>
                <classname>Zend_Service_Technorati_ResultSet</classname> は最も重要な結果セットです。
                クエリ固有の結果セットクラス群はこのクラスを継承して作成しています。
                このクラス自体のインスタンスを直接作成してはいけません。
                各子クラスは、クエリの種類に応じた
                <link linkend="zend.service.technorati.classes.result"><classname>Zend_Service_Technorati_Result</classname></link>
                オブジェクトのコレクションを表します。
            </para>
            <para>
                <classname>Zend_Service_Technorati_ResultSet</classname> は PHP の <code>SeekableIterator</code>
                インターフェイスを実装しており、<code>foreach</code>
                文で結果を処理することができます。
            </para>
            <example id="zend.service.technorati.classes.resultset.example-1">
                <title>結果セットコレクション内の結果オブジェクトの反復処理</title>
                <programlisting language="php"><![CDATA[
// 単純なクエリを実行します
$technorati = new Zend_Service_Technorati('VALID_API_KEY');
$resultSet = $technorati->search('php');

// $resultSet は Zend_Service_Technorati_SearchResultSet
// のインスタンスです
// これは Zend_Service_Technorati_ResultSet を継承しています
foreach ($resultSet as $result) {
    // Zend_Service_Technorati_SearchResult オブジェクトに対して
    // 何らかの操作をします
}
]]></programlisting>
            </example>
        </sect3>

        <sect3 id="zend.service.technorati.classes.cosmosresultset">
            <title>Zend_Service_Technorati_CosmosResultSet</title>
            <para>
                <classname>Zend_Service_Technorati_CosmosResultSet</classname> は
                Technorati Cosmos クエリの結果セットを表します。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_CosmosResultSet</classname> は
                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.searchresultset">
            <title>Zend_Service_Technorati_SearchResultSet</title>
            <para>
                <classname>Zend_Service_Technorati_SearchResultSet</classname> は
                Technorati Search クエリの結果セットを表します。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_SearchResultSet</classname> は
                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.tagresultset">
            <title>Zend_Service_Technorati_TagResultSet</title>
            <para>
                <classname>Zend_Service_Technorati_TagResultSet</classname> は
                Technorati Tag クエリの結果セットを表します。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_TagResultSet</classname> は
                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.dailycountsresultset">
            <title>Zend_Service_Technorati_DailyCountsResultSet</title>
            <para>
                <classname>Zend_Service_Technorati_DailyCountsResultSet</classname> は
                Technorati DailyCounts クエリの結果セットを表します。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_DailyCountsResultSet</classname> は
                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.tagsresultset">
            <title>Zend_Service_Technorati_TagsResultSet</title>
            <para>
                <classname>Zend_Service_Technorati_TagsResultSet</classname> は
                Technorati TopTags あるいは BlogPostTags クエリの結果セットを表します。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_TagsResultSet</classname> は
                    <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.result">
            <title>Zend_Service_Technorati_Result</title>
            <para>
                <classname>Zend_Service_Technorati_Result</classname> は最も重要な結果オブジェクトです。
                クエリ固有の結果クラス群はこのクラスを継承して作成しています。
                このクラス自体のインスタンスを直接作成してはいけません。
            </para>
        </sect3>

        <sect3 id="zend.service.technorati.classes.cosmosresult">
            <title>Zend_Service_Technorati_CosmosResult</title>
            <para>
                <classname>Zend_Service_Technorati_CosmosResult</classname> は
                Technorati Cosmos クエリの単一の結果オブジェクトを表します。
                単体のオブジェクトとして返されることはなく、常に
                <link linkend="zend.service.technorati.classes.cosmosresultset">Zend_Service_Technorati_CosmosResultSet</link>
                オブジェクトに含まれる形式で返されます。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_CosmosResult</classname> は
                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.searchresult">
            <title>Zend_Service_Technorati_SearchResult</title>
            <para>
                <classname>Zend_Service_Technorati_SearchResult</classname> は
                Technorati Search クエリの単一の結果オブジェクトを表します。
                単体のオブジェクトとして返されることはなく、常に
                <link linkend="zend.service.technorati.classes.searchresultset">Zend_Service_Technorati_SearchResultSet</link>
                オブジェクトに含まれる形式で返されます。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_SearchResult</classname> は
                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.tagresult">
            <title>Zend_Service_Technorati_TagResult</title>
            <para>
                <classname>Zend_Service_Technorati_TagResult</classname> は
                Technorati Tag クエリの単一の結果オブジェクトを表します。
                単体のオブジェクトとして返されることはなく、常に
                <link linkend="zend.service.technorati.classes.tagresultset">Zend_Service_Technorati_TagResultSet</link>
                オブジェクトに含まれる形式で返されます。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_TagResult</classname> は
                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.dailycountsresult">
            <title>Zend_Service_Technorati_DailyCountsResult</title>
            <para>
                <classname>Zend_Service_Technorati_DailyCountsResult</classname> は
                Technorati DailyCounts クエリの単一の結果オブジェクトを表します。
                単体のオブジェクトとして返されることはなく、常に
                <link linkend="zend.service.technorati.classes.dailycountsresultset">Zend_Service_Technorati_DailyCountsResultSet</link>
                オブジェクトに含まれる形式で返されます。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_DailyCountsResult</classname> は
                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.tagsresult">
            <title>Zend_Service_Technorati_TagsResult</title>
            <para>
                <classname>Zend_Service_Technorati_TagsResult</classname> は
                Technorati TopTags あるいは BlogPostTags クエリの単一の結果オブジェクトを表します。
                単体のオブジェクトとして返されることはなく、常に
                <link linkend="zend.service.technorati.classes.tagsresultset">Zend_Service_Technorati_TagsResultSet </link>
                オブジェクトに含まれる形式で返されます。
            </para>
            <note>
                <para>
                    <classname>Zend_Service_Technorati_TagsResult</classname> は
                    <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
                    を継承しています。
                </para>
            </note>
        </sect3>

        <sect3 id="zend.service.technorati.classes.getinforesult">
            <title>Zend_Service_Technorati_GetInfoResult</title>
            <para>
                <classname>Zend_Service_Technorati_GetInfoResult</classname> は
                Technorati GetInfo クエリの単一の結果オブジェクトを表します。
            </para>
        </sect3>

        <sect3 id="zend.service.technorati.classes.bloginforesult">
            <title>Zend_Service_Technorati_BlogInfoResult</title>
            <para>
                <classname>Zend_Service_Technorati_BlogInfoResult</classname> は
                Technorati BlogInfo クエリの単一の結果オブジェクトを表します。
            </para>
        </sect3>

        <sect3 id="zend.service.technorati.classes.keyinforesult">
            <title>Zend_Service_Technorati_KeyInfoResult</title>
            <para>
                <classname>Zend_Service_Technorati_KeyInfoResult</classname> は
                Technorati KeyInfo クエリの単一の結果オブジェクトを表します。
                これは
                <link linkend="zend.service.technorati.checking-api-daily-usage">Technorati API キーの使用状況</link>
                についての情報を提供します。
            </para>
        </sect3>

    </sect2>

</sect1>