ubicast Blogger が使用しているAPI
ubicast Blogger では、ブログへの記事投稿、記事一覧の取得、カテゴリ一覧の取得などブログとの通信のために、以下の3つのAPIの一部を使用しています。
- blogger API
仕様: Blogger API - www.blogger.com - metaWeblog API
仕様: RFC: MetaWeblog API - XML-RPC.Com - 現在ファイルが削除されているようです。
キャッシュ:
http://web.archive.org/web/20050325071920/http://www.xmlrpc.com/metaWeblogApi - web.archive.org - Movable Type API
仕様: Movable Typeユーザー・マニュアル: プログラミングインターフェイス>XML-RPC API - www.sixapart.jp
このページには、blogger API, metaWeblog API, MovableType API についての解説も掲載されています。
ubicast Blogger が対応するためには、それら3つをすべてブログ側で実装する必要はありませんが、ubicast Blogger の機能を最大限つかえるようにするためには、表1 に列挙されている推奨のメソッドを実装してください。
表1 で、推奨が○の項目は、他のメソッドの代替や重要ではないメソッドです。◎のメソッドを実装していれば、ubicast Blogger に対応する上で実装する必要ありません。
| メソッド | 推奨 | 使用状況 |
|---|---|---|
| blogger.newPost | ○ | metaWeblog.newPost が実装されていない場合に使用 |
| blogger.editPost | ○ | metaWeblog.editPost が実装されていない場合に使用 |
| blogger.deletePost | 必須 | 使用 |
| blogger.getRecentPosts | ○ | metaWeblog.getRecentPosts が実装されていない場合に使用 |
| blogger.getUsersBlogs | 必須 | 使用 |
| blogger.getUserInfo | ◎ | アカウント作成時のテストで使用 |
| metaWeblog.newPost | ◎ | 実装されてる場合は使用。ない場合は、blogger.newPost を使用 |
| metaWeblog.editPost | ◎ | 実装されている場合は使用。ない場合は、blogger.editPost を使用 |
| metaWeblog.getPost | ◎ | 投稿後の記事の確認等で使用 |
| metaWeblog.getRecentPosts | ◎ | 実装されている場合は使用。ない場合は、blogger.getRecentPosts を使用 |
| metaWeblog.newMediaObject | ◎ | ファイルのアップロードで仕様 |
| mt.getRecentPostTitle | 未使用 | |
| mt.getCategoryList | ◎ | カテゴリ一覧の取得に使用 |
| mt.getPostCategories | ◎ | 使用 |
| mt.setPostCategories | ◎ | 使用 |
| mt.supportedTextFilters | ある場合は使用 | |
| mt.getTrackbackPings | 未使用 | |
| mt.publishPost | ○ | ある場合は使用 |
対応している記事の拡張フィールド
Movable Type などにおいて、metaWeblog.newPost, editPost, getRecentPosts の記事についてのフィールドには、"mt_" ではじまる拡張フィールドが使えます。ubicast Blogger はこれらのフィールドに対応しておりますが、もし対応していなくても動作は可能です。
しかし、追記やキーワード設定、投稿オプションの指定などを ubicast Blogger で使用できるようにするには、これらのフィールドをサポートすることをお奨めします。これらのフィールドの詳しい説明は、Movable Typeユーザー・マニュアル: プログラミングインターフェイス>XMl-RPC API>metaWeblog.newPost をご覧ください。
| フィールド | 機能 |
|---|---|
| mt_excerpt | 記事の概要につかわれます。よく、トラックバックを送信する際に、生地の概要としてこの値が使われます。ubicast Blogger では、入力されていない場合自動的に本文から生成します。このフィールドがつかえない場合は、概要のウィンドウがグレーになり使用不可になります。 |
| mt_text_more | 記事の追記に使われます。このフィールドがつかえない場合は、追記のウィンドウがグレーになり使用不可になります。 |
| mt_allow_comments | 記事に対するコメントの許可/不許可の指定に使われます。このフィールドがつかえない場合、投稿オプションの「コメントの許可」のチェックがグレーになり使用不可になります。 |
| mt_allow_pings | 記事に対するトラックバックの許可/不許可の指定に使われます。このフィールドがつかえない場合、投稿オプションの「トラックバックの許可」のチェックがグレーになり使用不可になります。 |
| mt_convert_breaks | 本文の改行を、<br />に自動変換しないようにするために内部で使われます。 |
| mt_keywords | 記事のキーワードの指定に使われます。このフィールドがつかえない場合は、キーワードのウィンドウがグレーになり使用不可になります。 |
