たけまる / GData - AtomPP からの拡張
2007-01-07
_
GData - AtomPP からの拡張 [gdata]
AtomPP から拡張された点を中心にまとめてみました．なお，GData 仕様の翻訳は [2007-01-06] にあります．
主な拡張点
- kind (エントリの型) - RSS 2.0, JSON の利用 (GET のみ) - サービス，カテゴリ文書がない - クエリ (q=, /category, etc.) - 独自の認証方法 - 排他制御
■ 名前空間
xmlns:gd="http://schemas.google.com/g/2005"
■ フィード，エントリ文書
OpenSearch 1.1 レスポンス要素
| 検索結果数 | /feed/openSearch:totalResults |
| 検索結果開始番号 | /feed/openSearch:startIndex |
| ページあたりの検索結果数 | /feed/openSearch:itemsPerPage |
/feed/link/@rel
| http://schemas.google.com/g/2005#feed | Atom フィード全体を取得できる URI (GET) |
| http://schemas.google.com/g/2005#post | Atom フィードの POST URI |
| self | そのリソース自身の URI |
| previous | クエリ結果が分割されているとき，ひとつ前の URI |
| next | クエリ結果が分割されているとき，次の URI |
| edit | Atom エントリの Edit URI (PUT, DELETE) |
フィード (検索結果) の例
kind: エントリの型 (Atom Construct に似ている)
| Contact | 連絡先 (人物，場所) |
| Event | イベント，予定 |
| Message | メール，レビュー |
■ サービス，カテゴリ文書
使わない．
■ URI (クエリ)
| カテゴリ | /myFeed/-/cat1/cat2 (AND検索), /myFeed/-/cat1|cat2 (OR検索) |
| エントリID | /myFeed/entryID/ |
| バージョン | /myFeed/entryID/version/ |
| 全文検索 | /myFeed/?q=keyword |
| Author指定 | /myFeed/?author=keyword |
| RSS 2.0 | /myFeed/?alt=rss |
| 更新時刻 | /myFeed/?published-min=2005-04-19T15:30:00&published-max=2005-04-20T15:30:00 |
| インデックス | /myFeed/?start-index=1&max-results=10 |
■ 認証
| ClientLogin | クライアントアプリケーションからの認証 |
| AuthSub | 認証API |
| Basic Auth | 使わない? |
| WSSE | 使わない? |
■ Optimistic Concurrency
排他制御の実装方法．PUT したとき，編集したエントリと現行エントリの
バージョンが違ったら，編集中に他のクライアントが更新を行ったという
ことなので，更新を拒否する．
一言メッセージをこっそり送信できます (非公開)
Referrer (Inside): [2007-11-29-1]
