Zend_Service_ShortUrl

Zend_Service_SlideShare(日本語)

Zend_Service_SlideShare コンポーネントは、 » slideshare.net ウェブサービスを操作するためのものです。 これは、スライドショーをオンラインで公開するためのサービスです。 このコンポーネントを使用すると、 公開されているスライドをウェブサイトに埋め込んだり 新しいスライドショーを自分のアカウントにアップロードしたりできます。

Zend_Service_SlideShare の使い方

Zend_Service_SlideShare コンポーネントを使うには、まず slideshare.net のアカウントを作成して (詳細は » こちら を参照ください) API キーやユーザ名、パスワード、そして共有する秘密の値を取得しなければなりません。 Zend_Service_SlideShare コンポーネントを使用するには、これらすべてが必要です。

アカウントを取得したら、Zend_Service_SlideShare を使い始めることができます。Zend_Service_SlideShare オブジェクトのインスタンスを作成し、それぞれの値を次のように指定しましょう。

  1. // このコンポーネントの新しいインスタンスを作成します
  2. 'APIKEY',
  3.                                   'SHAREDSECRET',
  4.                                   'USERNAME',
  5.                                   'PASSWORD');

SlideShow オブジェクト

Zend_Service_SlideShare コンポーネントのすべてのスライドショーは Zend_Service_SlideShare_SlideShow オブジェクトで表されます (取得する際も新規スライドショーのアップロードの際も同じです)。 このクラスの構造を擬似コードで表すと次のようになります。

  1. span style="color: #808080; font-style: italic;">/**
  2.      * スライドショーの場所を取得します
  3.      *//**
  4.      * スライドショーのトランスクリプトを取得します
  5.      *//**
  6.      * スライドショーにタグを追加します
  7.      *//**
  8.      * スライドショーにタグを設定します
  9.      *//**
  10.      * スライドショーに関連付けられているすべてのタグを取得します
  11.      *//**
  12.      * ローカルファイルシステム上でのスライドショーのファイル名を設定します
  13.      * (新規スライドショーのアップロード用)
  14.      *//**
  15.      * アップロードしようとしているスライドショーの
  16.      * ローカルファイルシステム上でのファイル名を取得します
  17.      *//**
  18.      * スライドショーの ID を取得します
  19.      *//**
  20.      * スライドショーの HTML 埋め込み用のコードを取得します
  21.      *//**
  22.      * スライドショーのサムネイルの URL を取得します
  23.      *//**
  24.      * スライドショーのタイトルを設定します
  25.      *//**
  26.      * スライドショーのタイトルを取得します
  27.      *//**
  28.      * スライドショーの説明を設定します
  29.      *//**
  30.      * スライドショーの説明を取得します
  31.      *//**
  32.      * サーバ上でのスライドショーの状態を表す数値を取得します
  33.      *//**
  34.      * サーバ上でのスライドショーの状態を表す説明テキストを取得します
  35.      *//**
  36.      * スライドショーのパーマネントリンクを取得します
  37.      *//**
  38.      * スライドショーの閲覧回数を取得します
  39.      */

Note: 上の擬似クラスは、開発者がどんなメソッドを使えるのかを示すためだけのものです。 それ以外に、内部で用いられているメソッドもあります。

Zend_Service_SlideShare コンポーネントを使う際には、 このデータクラスを使用してスライドショーの閲覧や追加を行うことになります。

単一のスライドショーの取得

Zend_Service_SlideShare コンポーネントのもっともシンプルな使用法は、 slideshare.net が提供するスライドショー ID を指定して単一のスライドショーを取得することです。 これは、Zend_Service_SlideShare オブジェクトの getSlideShow() メソッドで行います。 そして、返された Zend_Service_SlideShare_SlideShow オブジェクトをこのように使用します。

  1. // このコンポーネントの新しいインスタンスを作成します
  2. 'APIKEY',
  3.                                   'SHAREDSECRET',
  4.                                   'USERNAME',
  5.                                   'PASSWORD'"スライドショーのタイトル: {$slideshow->getTitle()}<br/>\n""閲覧回数: {$slideshow->getNumViews()}<br/>\n";

スライドショーのグループの取得

取得したいスライドショーの ID がわからない場合は、 以下の 3 つのうちのいずれかの方法でスライドショーのグループを取得します。

  • 特定のアカウントでアップロードしたスライドショー

    特定のアカウントのスライドショーを取得するには getSlideShowsByUsername() メソッドを使用します。 スライドショーを取得したいユーザ名を指定します。

  • 特定のタグを含むスライドショー

    特定の (ひとつあるいは複数の) タグを含むスライドショーを取得するには getSlideShowsByTag() メソッドを使用します。 スライドショーを取得したい (ひとつあるいは複数の) タグを指定します。

  • 特定のグループに属するスライドショー

    特定のグループに属するスライドショーを取得するには getSlideShowsByGroup() メソッドを使用します。 取得したいスライドショーが属しているグループの名前を指定します。

これらの方法で複数のスライドショーを取得するやりかたは、どれもよく似ています。 各メソッドの使用例を以下に示します。

  1. // このコンポーネントの新しいインスタンスを作成します
  2. 'APIKEY',
  3.                                   'SHAREDSECRET',
  4.                                   'USERNAME',
  5.                                   'PASSWORD'// それぞれの方法で最初の 10 件を取得します
  6. 'username''zend''mygroup'// 個々のスライドショーを処理します
  7. "スライドショーのタイトル: {$slideshow->getTitle}<br/>\n";
  8. }

Zend_Service_SlideShare のキャッシュ処理のポリシー

デフォルトでは、Zend_Service_SlideShare はウェブサービスに対する任意のリクエストを自動的にキャッシュします。 キャッシュは、ファイルシステム上 (デフォルトのパスは /tmp) に 12 時間保存されます。この振る舞いを変更したい場合は、独自の Zend_Cacheオブジェクトを作成してそれを setCacheObject() メソッドでこのように指定します。

  1. span style="color: #ff0000;">'lifetime' => 7200,
  2.                         'automatic_serialization''cache_dir' => '/webtmp/''Core',
  3.                              'File''APIKEY',
  4.                                   'SHAREDSECRET',
  5.                                   'USERNAME',
  6.                                   'PASSWORD''username'

HTTP クライアントの振る舞いの変更

何らかの理由でウェブサービスにリクエストを送る HTTP クライアントの振る舞いを変更したくなったとしましょう。 そんな場合は、独自の Zend_Http_Client オブジェクトのインスタンスを作成します (Zend_Httpを参照ください)。これは、 たとえば接続のタイムアウト秒数をデフォルトから変更したい場合などに便利です。

  1. span style="color: #ff0000;">'timeout''APIKEY',
  2.                                   'SHAREDSECRET',
  3.                                   'USERNAME',
  4.                                   'PASSWORD''username'

Zend_Service_ShortUrl