Zend_Service_Technorati(日本語)注意:このドキュメントでは、英語版のリビジョン 22768 の更新内容をスキップしています。 導入Zend_Service_Technorati は、Technorati API を使うための簡単で直感的なオブジェクト指向インターフェイスを提供します。 利用可能なすべての » Technorati API クエリ にアクセスすることができ、API が返す XML 形式のレスポンスを PHP で扱いやすいオブジェクトで返します。 » Technorati は、人気のあるブログ検索エンジンのひとつです。その API を使用すると、 特定のブログについての情報を取得したり、 指定したタグやフレーズにマッチするブログの著者の情報を取得したりできます。 使用できるクエリの一覧は、 » Technorati API ドキュメント あるいはこのドキュメントの 使用できる Technorati クエリ を参照ください。 さあ始めましょうTechnorati API を使用するには、キーが必要です。 API キーを取得するには、まず最初に » Technorati アカウントを作成 し、それから » API キーのセクション に行ってください。
API キーを取得したら、いよいよ Zend_Service_Technorati を使うことができます。 はじめてのクエリクエリを実行するにはまず最初に API キーを使用して Zend_Service_Technorati のインスタンスを作成します。 そしてクエリの形式を選択し、引数を指定したうえでそれをコールします。 Example #1 はじめてのクエリの実行
検索用のメソッドにはオプションパラメータの配列を渡すことができます。 これを使用すると、クエリをさらに絞り込むことができます。 Example #2 クエリの精度の向上
Zend_Service_Technorati のインスタンスは使い捨てのオブジェクトではありません。 したがって、クエリをコールするたびに毎回新たなインスタンスを作成するなどということは不要です。 一度作成した Zend_Service_Technorati オブジェクトを、気の済むまで使い回せばいいのです。 Example #3 ひとつの Zend_Service_Technorati インスタンスでの複数のクエリの送信
結果の取得クエリの結果は、二種類の結果オブジェクトのうちのいずれかの形式で取得できます。
まず最初の形式は Zend_Service_Technorati_*ResultSet
オブジェクトで表されるものです。結果セットオブジェクトは、
基本的には結果オブジェクトのコレクションとなります。これは基底クラス
Zend_Service_Technorati_ResultSet を継承したもので、
PHP の Example #4 結果セットオブジェクトの取得
Zend_Service_Technorati_ResultSet は Example #5 特定の結果セットオブジェクトの取得
2 番目の形式は、単体の特別な結果オブジェクトで表されるものです。 Zend_Service_Technorati_GetInfoResult、Zend_Service_Technorati_BlogInfoResult および Zend_Service_Technorati_KeyInfoResult は、 Zend_Service_Technorati_Author や Zend_Service_Technorati_Weblog といったオブジェクトのラッパーとして働きます。 Example #6 単体の結果オブジェクトの取得 レスポンスクラスの詳細については Zend_Service_Technorati クラス のセクションを参照ください。 エラー処理Zend_Service_Technorati のクエリメソッドは、失敗したときには Zend_Service_Technorati_Exception をスローします。 またその際にはわかりやすいエラーメッセージを提供します。 Zend_Service_Technorati のクエリが失敗する原因は、いくつか考えられます。 Zend_Service_Technorati は、クエリを送信する際にすべてのパラメータを検証します。 もし無効なパラメータや無効な値を指定していた場合は Zend_Service_Technorati_Exception をスローします。 さらに、Technorati API が一時的に使用できなくなっていたり、 そのレスポンスが整形式でない場合もあり得るでしょう。
Technorati のクエリは、常に Example #7 クエリの例外処理
API キーの使用限度の確認今日は後何回 API キーが使えるのかを調べたいことも多々あるでしょう。 デフォルトでは、Technorati の API は 1 日あたり 500 回までしか使用することができません。 それを超えて使用しようとすると、Zend_Service_Technorati は例外を返します。自分の API キーの使用状況を取得するには Zend_Service_Technorati::keyInfo() メソッドを使用します。 Zend_Service_Technorati::keyInfo() は Zend_Service_Technorati_KeyInfoResult オブジェクトを返します。 詳細は » API リファレンスガイド を参照ください。 使用できる Technorati クエリZend_Service_Technorati は以下のクエリをサポートしています。 Technorati Cosmos» Cosmos クエリは、指定した URL にリンクしているブログを探します。このクエリは Zend_Service_Technorati_CosmosResultSet オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::cosmos() を参照ください。 Example #9 Cosmos クエリ Technorati Search» Search クエリは、指定した検索文字列を含むブログを探します。このクエリは Zend_Service_Technorati_SearchResultSet オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::search() を参照ください。 Example #10 Search クエリ Technorati Tag» Tag クエリは、指定したタグがつけられている投稿を探します。このクエリは Zend_Service_Technorati_TagResultSet オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::tag() を参照ください。 Example #11 Tag クエリ Technorati DailyCounts» DailyCounts クエリは、指定したキーワードを含む投稿の 1 日あたりの数を返します。このクエリは Zend_Service_Technorati_DailyCountsResultSet オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::dailyCounts() を参照ください。 Technorati TopTags» TopTags クエリは、Technorati にもっとも多く登録されているタグの情報を返します。このクエリは Zend_Service_Technorati_TagsResultSet オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::topTags() を参照ください。 Example #13 TopTags タグ Technorati BlogInfo» BlogInfo は、指定した URL に関連するブログの情報を返します。このクエリは Zend_Service_Technorati_BlogInfoResult オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::blogInfo() を参照ください。 Example #14 BlogInfo クエリ
Technorati BlogPostTags» BlogPostTags クエリは、そのブログでよく使われているタグの情報を返します。このクエリは Zend_Service_Technorati_TagsResultSet オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::blogPostTags() を参照ください。 Example #15 BlogPostTags クエリ Technorati GetInfo» GetInfo クエリは、あるメンバーについて Technorati が把握している情報を返します。このクエリは Zend_Service_Technorati_GetInfoResult オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::getInfo() を参照ください。 Example #16 GetInfo クエリ Technorati KeyInfoKeyInfo クエリは、API キーの使用状況についての情報を返します。このクエリは Zend_Service_Technorati_KeyInfoResult オブジェクトを返します。詳細は » API リファレンスガイド の Zend_Service_Technorati::keyInfo() を参照ください。 Zend_Service_Technorati クラス
以下のクラスは、Technorati の各種クエリから返されるものです。
Zend_Service_Technorati_*ResultSet 系のクラスは、
それぞれの形式にあわせた結果セットを保持します。
その中身は形式にあわせた結果オブジェクトであり、容易に処理できます。
これらの結果セットクラスはすべて
Zend_Service_Technorati_ResultSet クラスを継承しており、かつ
Zend_Service_Technorati には、これ以外にも 特定のレスポンスオブジェクトを表す便利なクラスが含まれています。 Zend_Service_Technorati_Author は、Technorati のアカウント (ブログの著者、いわゆるブロガー) を表します。 Zend_Service_Technorati_Weblog は単一のウェブログオブジェクトを表します。 ここには、フィードの URL やブログ名などの情報が含まれます。詳細は » API リファレンスガイド の Zend_Service_Technorati を参照ください。 Zend_Service_Technorati_ResultSetZend_Service_Technorati_ResultSet は最も重要な結果セットです。 クエリ固有の結果セットクラス群はこのクラスを継承して作成しています。 このクラス自体のインスタンスを直接作成してはいけません。 各子クラスは、クエリの種類に応じた Zend_Service_Technorati_Result オブジェクトのコレクションを表します。
Zend_Service_Technorati_ResultSet は PHP の Example #17 結果セットコレクション内の結果オブジェクトの反復処理
Zend_Service_Technorati_CosmosResultSetZend_Service_Technorati_CosmosResultSet は Technorati Cosmos クエリの結果セットを表します。
Zend_Service_Technorati_SearchResultSetZend_Service_Technorati_SearchResultSet は Technorati Search クエリの結果セットを表します。
Zend_Service_Technorati_TagResultSetZend_Service_Technorati_TagResultSet は Technorati Tag クエリの結果セットを表します。
Zend_Service_Technorati_DailyCountsResultSetZend_Service_Technorati_DailyCountsResultSet は Technorati DailyCounts クエリの結果セットを表します。
Zend_Service_Technorati_TagsResultSetZend_Service_Technorati_TagsResultSet は Technorati TopTags あるいは BlogPostTags クエリの結果セットを表します。
Zend_Service_Technorati_ResultZend_Service_Technorati_Result は最も重要な結果オブジェクトです。 クエリ固有の結果クラス群はこのクラスを継承して作成しています。 このクラス自体のインスタンスを直接作成してはいけません。 Zend_Service_Technorati_CosmosResultZend_Service_Technorati_CosmosResult は Technorati Cosmos クエリの単一の結果オブジェクトを表します。 単体のオブジェクトとして返されることはなく、常に Zend_Service_Technorati_CosmosResultSet オブジェクトに含まれる形式で返されます。
Zend_Service_Technorati_SearchResultZend_Service_Technorati_SearchResult は Technorati Search クエリの単一の結果オブジェクトを表します。 単体のオブジェクトとして返されることはなく、常に Zend_Service_Technorati_SearchResultSet オブジェクトに含まれる形式で返されます。
Zend_Service_Technorati_TagResultZend_Service_Technorati_TagResult は Technorati Tag クエリの単一の結果オブジェクトを表します。 単体のオブジェクトとして返されることはなく、常に Zend_Service_Technorati_TagResultSet オブジェクトに含まれる形式で返されます。
Zend_Service_Technorati_DailyCountsResultZend_Service_Technorati_DailyCountsResult は Technorati DailyCounts クエリの単一の結果オブジェクトを表します。 単体のオブジェクトとして返されることはなく、常に Zend_Service_Technorati_DailyCountsResultSet オブジェクトに含まれる形式で返されます。
Zend_Service_Technorati_TagsResultZend_Service_Technorati_TagsResult は Technorati TopTags あるいは BlogPostTags クエリの単一の結果オブジェクトを表します。 単体のオブジェクトとして返されることはなく、常に Zend_Service_Technorati_TagsResultSet オブジェクトに含まれる形式で返されます。
Zend_Service_Technorati_GetInfoResultZend_Service_Technorati_GetInfoResult は Technorati GetInfo クエリの単一の結果オブジェクトを表します。 Zend_Service_Technorati_BlogInfoResultZend_Service_Technorati_BlogInfoResult は Technorati BlogInfo クエリの単一の結果オブジェクトを表します。 Zend_Service_Technorati_KeyInfoResultZend_Service_Technorati_KeyInfoResult は Technorati KeyInfo クエリの単一の結果オブジェクトを表します。 これは Technorati API キーの使用状況 についての情報を提供します。
|
|