Google API Japanese@Wiki

Google Data APIs Protocol

2011-02-17T16:56:33+09:00

Google Data APIs Protocol

ThisdocumentdescribestheprotocolusedbytheGoogledataAPIs("GData"),includinginformationaboutwhataquerylookslike,whatresultslooklike,andsoon.
このドキュメントは、GoogledataAPIs("GData")が、どのようなquery（問い合わせ）やresults（結果）が使用されるのかの関連情報を情報を含んでいます。

ForotherinformationabouttheGoogledataAPIs,seetheGoogleDataAPIsOverviewdocument.
GoogledataAPIsについての他の情報は、GoogleDataAPIsOverviewを参照して下さい。

Contents
内容・目次

Audience
対象読者

Examples
例

Requesting a feed or other resource
feedやその他リソースの要求
Inserting a new entry
新しいエントリーの挿入
Searching for a string
文字列の検索
Updating an entry
エントリーの更新
Deleting an entry
エントリーの削除

Protocol details
プロトコル詳細

Document format
ドキュメント・フォーマット
Queries
問い合わせ
Optimisticconcurrency(versioning)
楽観的　同時実行
Authentication
認証
Session state
セッション状態

Additional resources
追加リソース

Audience
対象読者

ThisdocumentisintendedforanyonewantingtounderstandthedetailsoftheXMLformatandprotocolusedbytheGoogledataAPIs.
このドキュメントは、GoogledataAPIsが使用するXMLフォーマットとプロトコルの詳細を知りたい、理解したいと思う人の為に意図される。

IfyoujustwanttowritecodethatusestheGDataclientAPIs,thenyoudon'tneedtoknowthesedetails;instead,
seethelinksinthesidebartodocumentationforthelanguage-specificclientlibraries.
もし、GDataclientAPIsを使用するコードをただ書きたければ、これらの詳細を知る必要はありません。
その代わりに、言語に特化したクラスライブラリに関してのドキュメントへのリンクを参照して下さい。

If you want to understand the protocol, read this document.
もし、あたながプロトコルを理解したい場合には、このドキュメントを読んで下さい。

Forexample,youmaywanttoreadthisdocumenttohelpyouwithanyofthefollowingtasks:
例えば、以下のタスクについてあなたを手助けする為にこのドキュメントを読みたいと理由でもかまいません。

evaluating the GData architecture .
GDataアーキテクチャ評価

coding using the protocol without using the provided GData libraries .
提供されたGDataクラスライブラリを使用せずに、プロトコルをコーディングする

writing a client library in a new language .
新しい言語で、クラスライブラリをコーディングする

ThisdocumentassumesthatyouunderstandthebasicsofXML,namespaces,syndicatedfeeds,andtheGET,POST,PUT,andDELETErequestsinHTTP,
aswellasHTTP'sconceptofa"resource."Formoreinformationaboutthosethings,seetheAdditionalresourcessectionofthisdocument.
このドキュメントは、XMLやnamespacesやsyndicatedfeedsの基礎知識とHTTPのGET,POST,PUT,,DELETE要求やHTTP'sのリソースコンセプトを理解している前提で記述されています。
それらに関しての詳細な情報については、このドキュメントの追加リソースのセクションを参照して下さい。

This document doesn't rely on any particular programming language;
このドキュメントは、特定のプログラミング言語には依存しません。
youcansendandreceiveGDatamessagesusinganyprogramminglanguagethatletsyouissueHTTPrequestsandparseXML-basedresponses.
HTTPrequestsを送信したりXMLベースのレスポンスを解析
プログラミング言語を使用して、GDataメッセージをHTTPでリクエストを出さたり、、XMLベースのレスポンス（GDataメッセージ）を解析させる事ができます。

Examples
例

ThefollowingexamplesshowbareGDataprotocolrequestsyoumightsendandtheGData-formattedresultsyoumightreceive.
次の例は、送信したrequestsによって受け取るだろうGData-formatted結果のGDataプロトコルそのものを示します。
ForexamplesofhowtosendtherequestsusingJavaandC#,seethelanguage-specificclientlibrarylinksinthesidebar.
JavaとC#を使用したrequestsを送信する例は、それぞれのクラスライブライブラリに特化したドキュメントリンクを参照して下さい。
ForinformationaboutusingGDatawithGoogleCalendar,seetheGoogleCalendarDataAPIdocument.
GoogleカレンダーがもっているGDataに関する情報については、GoogleCalendarDataAPIdocumentを参照して下さい。

Requesting a feed or other resource

Assumethere'safeedcalled/myFeed,andassumethatitcurrentlydoesn'thappentocontainanyentries.
/myFeedというfeedがあると仮定して、そしてそれが現在どんなエントリーを含まないと仮定して下さい。
To see it, send the following request to the server:
それを参照するには、サーバーへ次のリクエストを送信して下さい。

GET /myFeedThe server responds:

200 OK

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Foo</title>
<updated>2006-01-23T16:25:00-08:00</updated>
<id>http://www.example.com/myFeed</id>
<author>
<name>Jo March</name>
</author>
<link href="/myFeed" rel="self"/>
</feed>

Notethatalthoughthefeeddoesn'tcontainanyentries,itdoescontainmetadata,suchasatitleandanauthor'sname.
feedは、なにもエントリーを含んで無いにも関わらず、タイトルと著者の名前といったメタデータを含む事に注意してください。

Inserting a new entry

To create a new entry, sendaPOSTrequest,andsupplyanewentryinGDataformat:
新しいエントリーを作成する為には、GDataフォーマットで新しいエントリーを作成しPOSTrequestを送信して下さい。

POST /myFeed

<?xml version="1.0"?>
<entry xmlns="http://www.w3.org/2005/Atom">
<author>
<name>Elizabeth Bennet</name>
<email>liz@example.com</email>
</author>
<title type="text">Entry 1</title>
<content type="text">This is my entry</content>
</entry>

Notethatyoudon'tsupplyid,link,orupdatedelements;theservercreatesthoseinresponsetoyourPOSTrequest.
id、link、updatedの要素を提供しない事に注意して下さい。;サーバーは、あなたのPOSTrequestに応じてそれらを作成します。
Alsonotethattheauthorofafeeddoesn'thavetobethesamepersonastheauthorofanentry.
さらにfeedの著者が、エントリーの作成と同一人物である必要がないことに注意してください。

The server responds:

201 CREATED

<?xml version="1.0"?>
<entry xmlns="http://www.w3.org/2005/Atom">
<id>1</id>
<link rel="edit" href="http://example.com/myFeed/1/1/"/>
<updated>2006-01-23T16:26:03-08:00</updated>
<author>
<name>Elizabeth Bennet</name>
<email>liz@example.com</email>
</author>
<title type="text">Entry 1</title>
<content type="text">This is my entry</content>
</entry>

Searching for a string

Todoafull-textsearchforaparticularstring,sendaGETrequestwiththeqparameter.
特定の文字列用に全文検索を行う為には、qパラメーターを備えたGETrequestを送信して下さい。
For more information about queryparameters, see Query requests.
クエリー・パラメーターの詳細の詳細については、Queryrequestsを参照して下さい。

GET /myFeed?q=This

Theserverrespondswithalltheentriesthatmatchthesearchstring"This".(Inthiscasethere'sonlyone.)
サーバーは、検索文字列"This"とマッチするすべてのエントリーで応答します。(この場合1つだけあります。)

200 OK

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Foo</title>
<updated>2006-01-23T16:26:03-08:00</updated>
<id>http://www.example.com/myFeed</id>
<author>
<name>Jo March</name>
</author>
<link href="/myFeed" rel="self"/>
<entry>
<id>1</id>
<link rel="edit" href="http://example.com/myFeed/1/1/"/>
<updated>2006-01-23T16:26:03-08:00</updated>
<author>
<name>Elizabeth Bennet</name>
<email>liz@example.com</email>
</author>
<title type="text">Entry 1</title>
<content type="text">This is my entry</content>
</entry>
</feed>

Updating an entry

Toupdateanexistingentry,usePUT,usingtheentry'seditURI(asprovidedbytheserverinthepreviousexample).
すでに存在するエントリーを更新するためには、エントリーの編集URIを使用した、PUTを使用して下さい。(前の例のサーバーによって提供される)

(IfyourfirewalldoesnotallowPUT,thendoanHTTPPOSTandsetthemethodoverrideheaderasfollows:X-HTTP-Method-Override:PUT)
(もし、あなたのファイアーウォールがPUTを許可しない時は、HTTPPOSTでヘッダーメソッドを次の通りにオーバーライドして下さい。（X-HTTP-Method-Override:PUT）)

Inthefollowingexample,we'rechangingtheentry'stextfromitsoldvalue("Thisismyentry")toanewvalue("Thisismyfirstentry."):
次の例では、私達は、古い値"Thisismyentry"から新しい値"Thisismyfirstentry."へテキストエントリーを変更しています。

PUT /myFeed/1/1/

<?xml version="1.0"?>
<entry xmlns="http://www.w3.org/2005/Atom">
<id>1</id>
<link rel="edit" href="http://example.com/myFeed/1/1/"/>
<updated>2006-01-23T16:28:05-08:00</updated>
<author>
<name>Elizabeth Bennet</name>
<email>liz@example.com</email>
</author>
<title type="text">Entry 1</title>
<content type="text">This is my first entry.</content>
</entry>

The server responds:

200 OK

<?xml version="1.0"?>
<entry xmlns="http://www.w3.org/2005/Atom">
<id>1</id>
<link rel="edit" href="http://example.com/myFeed/1/2/"/>
<updated>2006-01-23T16:28:05-08:00</updated>
<author>
<name>Elizabeth Bennet</name>
<email>liz@example.com</email>
</author>
<title type="text">Entry 1</title>
<content type="text">This is my first entry.</content>
</entry>

Note that the edit URI has changed; it now ends with"/2/"insteadof"/1/".
編集URIが、変わった事に注意して下さい。それは今、"/1/"では無く、"/2/"で終わります。
The final number in the edit URI is a version number.
編集URIの最終番号はバージョン・ナンバーである。
Formoreinformationaboutversions,seetheOptimisticconcurrencysectionofthisdocument.
バージョンに関してのより詳細な情報については、この文書内の、楽観的な同時実行のセクションを見てください。

To see the new entry in context, request the entire resource again:
コンテキストで新しいエントリーを見るためには、再度全エントリーを要求して下さい。

GET /myFeedThe server responds:

200 OK

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Foo</title>
<updated>2006-01-23T16:28:05-08:00</updated>
<id>http://www.example.com/myFeed</id>
<author>
<name>Jo March</name>
</author>
<link href="/myFeed" rel="self"/>
<entry>
<id>1</id>
<link rel="edit" href="http://example.com/myFeed/1/2/"/>
<updated>2006-01-23T16:28:05-08:00</updated>
<author>
<name>Elizabeth Bennet</name>
<email>liz@example.com</email>
</author>
<title type="text">Entry 1</title>
<content type="text">This is my first entry.</content>
</entry>
</feed>

Deleting an entry

Todeleteanexistingentry,sendaDELETErequest,usingtheentry'seditURI(asprovidedbytheserverinthepreviousexample).
既存のエントリーを削除する為には、編集URIを使用してDELETEリクエストを送信してください。（前の例におけるサーバーによって提供された）

(IfyourfirewalldoesnotallowDELETE,thendoanHTTPPOSTandsetthemethodoverrideheaderasfollows:X-HTTP-Method-Override:DELETE.)
（もし、あなたのファイアーウォールがDELETEを許可しない時は、HTTPPOSTのヘッダーメソッドを次の通りにオーバーライドして下さい。（X-HTTP-Method-Override:DELETE.））

DELETE /myFeed/1/2/

The server responds:

200 OK

DoanotherGETtoseethatthefeednowcontainsnoentries:
別のGETが、今のfeedを含まない事を見てください。

GET /myFeedThe server responds:

200 OK

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Foo</title>
<updated>2006-01-23T16:30:11-08:00</updated>
<id>http://www.example.com/myFeed</id>
<author>
<name>Jo March</name>
</author>
<link href="/myFeed" rel="self"/>
</feed>

If the deletion fails, then the server responds with an error code.
もし削除が失敗した場合、サーバーは、エラーコードで応答します。

For more information, see HTTP status codes, later in this document.
より詳細については、後でこの文書内のHTTPstatuscodesを参照して下さい。

Protocol details
プロトコル詳細

This section describes the GData document format and query syntax.
このセクションは、GDataドキュメント・フォーマット及び、query（問い合わせ）のsyntax（文法。規則）について詳しく記述します。

Document format
ドキュメント・フォーマット

GData, Atom, and RSS 2.0 all share the same basic data model:
GData、AtomとRSS2.0はすべて同じ基本データモデルを共有します：
a container that holds both some global data and anynumberofentries.
グローバルなデータおよびいくつもエントリーのを格納するcontainer（コンテナー）
Foreachprotocol,theformatisdefinedbyabaseschema,butitcanbeextendedusingforeignnamespaces.
それぞれのプロトコルは、基礎のスキーマによって定義されます、しかし、外部のnamespacesを使用して拡張する事が出来ます。

GDatacanuseeithertheAtomsyndicationformat(forbothreadsandwrites)ortheRSSformat(forreadsonly).
GDataは、Atomsyndicationformat(読み取りと書き込みの両方のための)と、RSSformat(読み取り専用の)どちらかを使用することが出来ます

Atom is GData's default format.
Atomは、GDataのデフォルトのフォーマットです。
TorequestaresponseinRSSformat,usethe/alt=rss/parameter;
RSSフォーマットでの応答を要求するためには、/alt=rss/parameter　を使用して下さい。
for more information, see Query requests.
詳細については、Queryrequestsを参照して下さい。

WhenyourequestdatainRSSformat,GDatasuppliesafeed(orotherrepresentationoftheresource)inRSSformat.
RSSフォーマットでのデータを要求する場合、GDataはRSSフォーマットでfeed(かリソースの他の表現)を供給します。
Ifthere'snoequivalentRSSpropertyforagivenGDataproperty,GDatausestheAtomproperty,labelingitwithanappropriatenamespacetoindicatethatit'sanextensiontoRSS.
もし、GDataの与えられたpropertyと同等のRSSpropertyが無い場合、GDataは、それがRSSに対する拡張であることを示す適切なネーム空間のラベルを付けてAtomを使用します。

Note:MostGDatafeedsinAtomformatusetheAtomnamespaceasthedefaultnamespacebyspecifyinganxmlnsattributeonthefeedelement;
注：ほとんどのGDatafeedsは、要素でxmlnsattributeを指定することによって、Atomformatの使用にdefaultnamespaceとしてAtomnamespaceを使用します
see the examples section for examples of how to do that.
それを使用する方法に関しては、例セクションを参照して下さい。
Thus,theexamplesinthisdocumentdon'texplicitlyspecifyatom:forelementsinanAtom-formatfeed.
従って、このドキュメント注の例は、明示的にatomを指定しません：Atom-formatfeed要素のためです。

ThefollowingtablesshowtheAtomandRSSrepresentationsoftheelementsoftheschema.
次のテーブルは、原子とRSSのスキーマの要素を表示し示します。
AlldatanotmentionedinthesetablesistreatedasplainXMLandshowsupthesameinbothrepresentations.
これらのテーブルで述べられてないデータは、すべてXMLとして明白に扱われ、両方同じ表現を示します。
Unlessindicatedotherwise,theXMLelementsinagivencolumnareinthenamespacecorrespondingtothatcolumn.
もし他の方法で示されなければ、与えられたカラムのXML要素は、そのカラムに対応するネーム空間にあります。
This summary uses standard XPath notation:
この要約は、標準のXPath表記法を使います:
inparticular,slashesshowtheelementhierarchy,andan@signindicatesanattributeofanelement.
特に,/　(スラッシュ)は要素階層を示し,@印は要素の属性を示す。

In each of the following tables, the highlighted items are required.
次のテーブルで、強調表示された項目は、要求される項目です。

The following table shows the elements of a GData feed:
次のテーブルが、GDatafeedの要素を示します:

FeedSchemaItem

AtomRepresentation

RSSRepresentation

Feed Title /feed/title /rss/channel/title
Feed ID /feed/id /rss/channel/atom:id
Feed HTML Link /feed/link[@rel="alternate"]
[@type="text/html"]/@href /rss/channel/link
Feed Description /feed/subtitle /rss/channel/description
Feed Language /feed/@xml:lang /rss/channel/language
Feed Copyright /feed/rights /rss/channel/copyright
Feed Author /feed/author/name /feed/author/email (Requiredincertaincases;seeAtomspecification.) /rss/channel/managingEditor
Feed Last Update Date /feed/updated
(RFC3339format) /rss/channel/lastBuildDate
(RFC822format)
Feed Category /feed/category/@term /rss/channel/category
Feed Category Scheme /feed/category/@scheme /rss/channel/category/@domain
Feed Generator /feed/generator
/feed/generator/@uri /rss/channel/generator
Feed Icon /feed/icon

/rss/channel/image/url
(unless there's also alogo,inwhichcasetheiconisn'tincludedinthefeed)

Feed Logo /feed/logo /rss/channel/image/url

The following tableshowstheelementsofaGDatasearch-resultsfeed.
次のテーブルはGDataの検索結果のfeedの要素を示したものだ。
NotethatGDataexposessomeoftheOpenSearch1.1Responseelementsinitssearch-resultsfeeds.
GDataがその検索-結果feedsでOpenSearch1.1Responseelementsの一部をさらすことに注意して下さい。

SearchResultFeedSchemaItem

Atom Representation

RSS/OpenSearchRepresentation

Number of Search Results /feed/opensearch:totalResults /rss/channel/opensearch:totalResults
Search Result Start Index /feed/opensearch:startIndex /rss/channel/opensearch:startIndex
Number of Search Results Per Page /feed/opensearch:itemsPerPage /rss/channel/opensearch:itemsPerPage

The following table shows the elements of a GData entry:
次のテーブルは、GDataのエントリー要素を示したものです。

Entry Schema Item

Atom Representation

RSS Representation

Entry ID /feed/entry/id /rss/channel/item/guid
Entry Version ID Optionally embedded in EditURI
(see theOptimistic concurrencysectionofthisdocument).
Entry Title /feed/entry/title /rss/channel/item/title
Entry Link /feed/entry/link /rss/channel/item/link
/rss/channel/item/enclosure
/rss/channel/item/comments
Entry Summary /feed/entry/summary
(Required in certain cases; see Atom specification.) /rss/channel/item/atom:summary
Entry Content /feed/entry/content
(If no content element, then entry must contain
at least one <link rel="alternate"> element.) /rss/channel/item/description
Entry Author /feed/entry/author/name
/feed/entry/author/email
(Required in certain cases; see Atom specification.) /rss/channel/item/author
Entry Category /feed/entry/category/@term /rss/channel/item/category
Entry Category Scheme /feed/entry/category/@scheme /rss/channel/item/category/@domain
Entry Publication Date /feed/entry/published　 (RFC 3339) /rss/channel/item/pubDate
(RFC 822)
Entry Update Date /feed/entry/updated　　(RFC3339) /rss/channel/item/atom:updated
(RFC 3339)
Queries
問い合わせ

Thissectiondescribeshowtousethequerysystem.
このセクションでは、問い合わせシステムの使用方法を記述します。

Query model design tenets
問い合わせモデル設計主義
Thequerymodelisintentionallyverysimple.
問い合わせモデルは計画的で非常に簡単である。
The basic tenets are:
基本的な主義は次のとおりである:

・Queries are expressed as HTTP URIs, rather thanasHTTPheadersoraspartofthepayload.
HTTPヘッダーとしてまたはペイロードの一部として表現されるよりもQueriesはHTTPURIsとして表現される。
One benefit of thisapproach is thatyoucan link to a query.
このアプローチの1つの利点は問い合わせにリンクすることができることである。
・Predicates are scoped to a single item.
クエリの述部は、単一項目に対して有効です。
Thus,there'snowaytosendacorrelationquery such as "find all emails frompeoplewho sentmeatleast10emailstoday."
従って、今日10通以上送信した人のすべてのEメールのような相関関係のクエリの方法はありません。
・The set of properties thatqueriescanpredicateonisverylimited;mostqueries are simply full textsearchqueries.
このセットのプロパティは非常に限定されています。ほとんどのクエリは、単に全文検索です。
・Result ordering is up to the implementation.
結果の命令は、実施までです。
・Theprotocolisnaturallyextensible.
このプロトコルは、当然拡張可能です。
Ifyouwanttoexposeadditionalpredicatesorsortingin your service, you candosoeasilythrough theintroductionofnewparameters.
もしあなたのサービスが、ソートや述語（条件）などの付加的な処理を追加する場合には、新しいパラメータを導入すれば容易にできます。

Query requests
クエリ　リクエスト

A client queries a GData service by issuing an HTTPGETrequest.
クライアントは、HTTPGETリクエストを出すことにより、GDataサービスに問い合わせします。
The query URI consists oftheresource'sURI(calledFeedURIinAtom)followedby query parameters.
問い合わせURIは、リソースのURI（AtomのFeedURIと呼ばれる）の後に続くクエリのパラメータから構成される。
Mostqueryparametersarerepresentedastraditional?name=value[&...]URLparameters.
ほとんどのクエリパラメータは、従来と同様です。URLパラメータ?name=value[&...]
Category parameters are handleddifferently; seebelow.
カテゴリー・パラメーターは違う様に扱われます。以下を見てください。
For example, if the FeedURI ishttp://www.example.com/feeds/jo,thenyoumightsendaquerywiththefollowing URI:
例えば、FeedURIがhttp://www.example.com/feeds/joである場合、以下のURIをもつクエリを送るでしょう:

http://www.example.com/feeds/jo?q=Darcy&updated-min=2005-04-19T15:30:00

GData services support HTTP Conditional GET.
GDataサービスはHTTPの条件付きのGETを支援します。
They set the Last-Modifiedresponseheaderbaseduponthevalueofthe<atom:updated> element in thereturnedfeedorentry.
それらは、返された最終更新のレスポンスヘッダーのfeedかentry内の<atom:updated>要素valueに基づいてセットされます。
A client can sendthis value backasthevalueoftheIf-Modified-Sincerequestheader to avoidretrievingthecontentagainifithasn't changed.
クライアントは、それが変わっていない場合には、再び内容を検索することを回避するリクエストヘッダーの場合のためにこの値を送り返すことが出来ます。
If the content hasn'tchangedsincetheIf-Modified-Sincetime,thentheGDataservice returns a 304(NotModified)HTTPresponse.
もし、その時間が変更ない場合、それからGDataサービスは304(変更されない)HTTPの応答を戻します。。

A GData service must support category queries and alt queries;
GDataサービスはカテゴリークエリおよびaltクエリをサポートしなければいけません。
support for other parameters is optional.
他のパラメーターに対するサポートは、選択が自由です。
Passing a standard parameter not understoodbyagivenserviceresultsina403Forbidden response.
特定のサービスによって理解されない標準パラメータを渡す場合には、403Forbiddenresponseを返します。
Passing an unsupportednonstandardparameterresultsina400BadRequestresponse.
サポートされていない標準外のパラメータを渡す事は、400BadRequestresponseを返します。
For information on otherstatuscodes, seethe HTTPstatuscodessectionofthisdocument.
他のステイタスコードの情報については、この文書のHTTPのステイタスコードセクションを見てください。

The standard query parametersaresummarizedinthefollowingtable.
標準的なクエリパラメータは次のテーブルに要約されています。
All parameter values need to be URL encoded.
すべてのパラメータの値はURLエンコードされている必要があります。

Parameter

Meaning

Notes

q Full-text query string When creating a query, list search termsseparatedbyspaces,inthe form q=term1 term2 term3.
問い合わせを作成する場合、検索用語リストは、スペースで区切った形でq=term1term2term3
(As with all of the query parameter values, the spaces must be URLencoded.)
（問い合わせのすべてのパラメータ値のと同じように、スペースは、URLエンコードしなくてはいけません）
The GData service returns all entries that match allofthesearchterms(like using AND between terms).
GDataサービスは、検索対象用語のすべて一致した結果を返します。(用語間のスペースがANDのように)
Like Google's web search, a GData service searchesoncompletewords(andrelated words with the same stem), not substrings.
GoogleWebの検索のようなsubstringsではなく、完全一致の単語（先頭から最後まで同じ単語）で検索します。

To search for an exact phrase, enclose the phraseinquotationmarks:q="exactphrase".
正確な句を検索するために、句を引用符で囲んでください。:q="exactphrase"

To exclude entries that match a given term, use the form q=-term.
ある特定の言葉に一致させる記入項目を除くためには、q=-termのように句の前に-を付けてください。

The search is case-insensitive.
探索はケース無感覚です。

Example: to search for all entries that contain theexactphrase"ElizabethBennet"and the word "Darcy" but don't contain theword"Austen",
use the following query: ?q="Elizabeth Bennet" Darcy -Austen
例：正確な句「エリザベス・ベネット」および単語「ダーシー」を含んでいるが、単語「オースティン」を含んでいないすべての
エントリーを探索するために、次のクエリを使用する　?q="ElizabethBennet"Darcy-Austen
/category Category filter
・List each category as if it were part oftheresource'sURI,in the form /categoryname/this is an exception totheusualname=valueform.
・それが、URIの一部のようにリストしてください。通常の形式の例外として、形式　/categoryname/this

・List all categories before any other query parameters.
・他のqueryparametersの前にすべてのカテゴリをリストアップして下さい。

・Precede thefirstcategorywith /-/ to make clear that it's acategory.
・それがカテゴリである事を明確にするために、カテゴリの前に/-/を付加してください。
For example, if Jo's feed has a category for entries aboutFritz,youcouldrequest those entries like this:
例えば、JofeedにFritzについてのカテゴリーを持っていれば、以下のようにそれらのentry項目を要求可能です。

・You can query on multiple categories bylistingmultiplecategory parameters, separated by slashes.
・多数のカテゴリーをスラッシュによって分割する事で、多数のカテゴリーリストとして問い合わせする事が出来る。
The GData service returns all entries that match all ofthecategories(like using AND between terms).
GDataサービスは、すべてに一致するエントリーをかえす。（AND検索）
For example:http://www.example.com/feeds/jo/-/Fritz/Lauriereturns entries that match both categories.
例えば、http://www.example.com/feeds/jo/-/Fritz/Laurieは、両方のカテゴリーと一致する項目を返します。

・To do an OR between terms, use a pipecharacter(|),URL-encoded as %7C.
・(|)によって用語を分割することで、ORとすることもできる。(|)は、%7CとしてURLエンコードされる。
For example:http://www.example.com/feeds/jo/-/Fritz%7CLauriereturns entries that match either category.
例えば、http://www.example.com/feeds/jo/-/Fritz%7CLaurieは、どちらかのカテゴリーに一致する項目を返します。

・An entry matches a specified category if the entry is inacategory that has a matching term or label, as defined in theAtomspecification.
・そのエントリーが、Atomの仕様で定義されているエントリーと一致する場合には、エントリーが用語かラベルに一致します。
(Roughly, the "term" is the internal string used by the software to identifythecategory,
while the "label" is the human-readable string presented to a user in auserinterface.)
（大体、用語("term")は、カテゴリーを識別するためにソフトウェアで使用される文字列です。
ラベル（"label"）が、ユーザーインタフェースで使用される文字列です。）

・To exclude entries that match a given category, usetheform /-categoryname/.
・ある特定のカテゴリーを除外する場合には、/-categoryname/　を使用しなさい。

・To query for a category that has a schemesuch as
<category scheme="urn:google.com" term="public"/>you must place theschemein curly braces before the category name.
・schemesuchを持っているカテゴリを問い合わせる場合には、<categoryscheme="urn:google.com"term="public"/>
カテゴリーの前から｛｝（中括弧）のペアを使ってください。
For example: /{urn:google.com}public. To match acategorythat has no scheme, use an empty pair of curly braces.
例えば、/{urn:google.com}public.　schemeを持たないカテゴリを一致させるには、{}を一組使ってください。
If you don't specify curly braces, then categories in any schemewillmatch.
もし、{}を使用しなければ、すべてのschemeと一致するでしょう。

・Theabovefeatures can be combined.
・それらの特徴は、組み合わせる事が出来ます。
For example: /A%7C-{urn:google.com}B/-C means (A OR(NOTB)) AND (NOT C).
例えば、/A%7C-{urn:google.com}B/-C　(A OR(NOTB)) AND (NOT C)を意味します。

author Entry author The service returns entries where the author name and/oremail address match your query string.
サービスは、あなたのquery文字列に一致する、作者名前および／またはEメールアドレスを返します。
alt Alternative representation type If you don't specify an alt parameter, the service returnsan Atom feed.
もし、altパラメータを使用しなければ、サーバーはAtomfeedを返します。
This is equivalent to alt=atom.
これは、alt=atom と同じです。
alt=rss returns an RSS 2.0 result feed.
alt=rss　を指定すると、RSS2.0を返します。

updated-min
updated-max
Bounds on the entry publication date Use the RFC 3339 timestamp format.
RFC3339タイムスタンプ・フォーマットを使用してください。
For example: 2005-08-09T10:57:00-08:00.
例えば、: 2005-08-09T10:57:00-08:00.
Thelower bound is inclusive, whereas the upper bound is exclusive.
上限は、排他的であるが、下限は、包括的である。
start-index 1-based index of the first result to beretrieved Note that this isn't a general cursoring mechanism.
これが一般的なcursoring メカニズムでないことに注意しなさい。
If you first send a query with ?start-index=1&max-results=10 and then send another query with ?start-index=11&max-results=10,
the service cannot guarantee that the results are equivalent to ?start-index=1&max-results=20,
because insertions and deletions could have taken place in between the two queries.
最初に ?start-index=1&max-results=10 の付加されたクエリを送れば、そしてだれかが、?start-index=11&max-results=10の付加されたクエリを送れば、
サービスは、挿入と削除が２つの問い合わせの間に起こったかもしれないので、結果が同じであることを保証しません。
max-results Maximum number of results to be retrieved
For any service that has a default max-results value (to limit default feed size),
you can specify a very large number if you want to receive the entire feed.
デフォルトでfeedの制限がある場合、サービス全体のfeedを取得したいと思えば、あなたが指定すればとても大きなSizeを指定することが出来ます

entryID ID of a specific entry to be retrieved If you specify an entry ID, you can't specify any other parameters.
もし、entry IDをすれば、ほかのパラメータは指定できません。
The form of the entry ID is determined by the GData service.
entry IDの形式は、GDataサービスによって定められています。
Unlike most of the other query parameters, entry ID is specified as part of the URI, not as a name=value pair.
他のほとんどのqueryパラメータと違い、entry IDは、name=value のペア形式じゃなくURLの一部として指定されます。
Example:http://www.example.com/feeds/jo/entry1.
例：http://www.example.com/feeds/jo/entry1.

Google Calendar HELP Japanese

2006-05-03T02:42:38+09:00

*原文リンク ---- -[[Google Data APIs Overview>http://code.google.com/apis/gdata/overview.html]] -[[Google Data APIs Protocol>http://code.google.com/apis/gdata/protocol.html]] -[[Common Elements: "Kinds" >http://code.google.com/apis/gdata/common-elements.html]] -[[Using the C# Client Library >http://code.google.com/apis/gdata/client-cs.html]] -[[Using the Google Calendar Data API >http://code.google.com/apis/gdata/calendar.html]] ---- *勝手に翻訳 -[[Google Data APIs Overview>http://www12.atwiki.jp/kaitarou/pages/5.html]] -[[Google Data APIs Protocol >http://www12.atwiki.jp/kaitarou/pages/6.html]]

Google Data APIs Overview Japanese

2006-05-02T22:04:13+09:00

Google Data APIs (Beta) Developer's Guide 　

GoogleDataAPIs(Beta)開発者のガイド　

Google Data APIs Overview 　

Google Data APIs 概略　

The GoogledataAPIs("GData"forshort)provideasimplestandardprotocolforreadingand writingdataontheweb.

GoogleDataAPIs(略して「GData」)は、ウェブ上のデータの読み書きに必要な、単純な標準プロトコルを供給します。

GDatacombinescommonXML-basedsyndicationformats(AtomandRSS)witha
　　feed-publishingsystembasedontheAtompublishingprotocol,plussomeextensionsforhandlingqueries.
GDataは、質問を扱うためのいくつかの拡張を加えて、プロトコルを公表するAtomに基づいた、材料を公表する
　システムと共通のXMLに基づいた組織化フォーマット(AtomとRSS)を組み合わせます。

　　 Contents
　　コンテンツ　

　　Background: Atom and RSS　
　　背景:AtomとRSS 　
　　About GData 　
　　GDataに関して　
　　Motivation: Why GData? And why Google?　
　　動機づけ:なぜGData?またなぜグーグル?

　　 1.Background: Atom and RSS
　　　　背景:AtomとRSS

There are two common XML-based syndicationformatsforfeedsandotherdatainterchange on the we
他のデータ網で交換し送信のための2つの共通のXML基づいていたsyndicationフォーマットがある
Atom and RSS
AtomとRSSである
RSS has been around longer,invariousversions;Atomis more recent buthasmore features.
RSSは、長く存在し様々なバージョンがありす。Atomは、RSSより最近ですが、より多くの特徴を持っています。

In addition to its syndication format, Atom providesapublishingprotocol;
そのsyndicationのフォーマットに加えて、Atomは公表しているプロトコルを提供します。
it's an HTTP-based protocol for publishing and editing webresources.
それは、ウェブ資源を公開し編集するためのHTTPに基づいたプロトコルです。

(The Atom publishing protocol specification isn't yetcomplete;it'sanemergingstandard, currently under development by the IETF.)
（Atomの公表しているプロトコル仕様はまだ完全でない;IETFによって現在開発中の新しい規格（標準）です。）
For example, using the Atom publishing protocol, you can sendaGETrequesttorequest a particular resource (such as a feed or entry);
例えば、Atomの公開しているプロトコルを使用して、あたなは、GETリクエストによって、特定（feedやエントリーのような）の資源を要求する事が出来ます。
the server returns a representation of that resourceintheAtomsyndicationformat.
サーバーは、Atomのsyndicationで、要求された資源を返します。
Or you can create, edit, or delete a resource, usingPOST,PUT,orDELETE,respectively.
あなたは、POST、PUT、DELETEのリクエストを使用して、資源を作成したり、編集したり、削除したりする事も出来ます。
This use of HTTP requests for a publishing and editingprotocolisinthespirit of the REST approach to web service interfaces.
この公表し編集するためのプロトコル（HTTPリクエスト）は、Webサービスの残りの精神である。

In various contexts, it's useful to be able to send a querytoaserverandreceive a response containing a list of matching results.
様々な情況で、サーバーへqueryを送り、一致する結果リストを含んだ応答を受け取る事は、有用です。
Neither Atom nor RSS provides a way to do that, but GData does.
AtomもRSSも、それをする方法を提供しないが、GDataは提供します。

2．About GData
GDataに関して

GData is a new protocol based on Atom 1.0 and RSS 2.0.
GDataはAtom1.0およびRSS2.0に基づいた新しいプロトコルです。

To acquireinformationfromaservicethatsupportsGData,yousendanHTTPGETrequest;
the service returns results as an Atom or RSS feed.
GDataをサポートするサービスから、情報を得るためには、HTTP　GETリクエストを送ります;
サービスは、AtomまたはRSSのfeedを結果として返します。

You can update data (where supported by a particular GData service)bysendingan HTTP PUT request, an approach based on the AtomPublishingProtocol.
あなたは、データ（特定のサービスによって既定されたGData）をHTTPPUTリクエストを送信する事で、更新することが出来ます。

All sorts of services can provide GData feeds, from public serviceslikeblogfeeds or news syndication feeds to personalized data like emailorcalendarevents or task-list items.
GDatafeedsは、公開されている各種のサービスのブログfeedsやカレンダーのイベントやタスクリストなのどのアイテムやEメールなどの個人的なデータを提供できます。
The RSS and Atom models are extensible, so each feed providercandefineits own extensions and semantics as desired.
RSSとAtomは、拡張可能モデルです、それぞれで拡張や望まれる意味を定義できます。
A feed provider can provide read-only feeds (such asasearch-resultsfeed) or read/write feeds (such as a calendar application).
従って、プロバイダー（feedを提供者）は、読み取り専用feed(探索結果feedのような)や、読み書きfeed(例えばカレンダー・アプリケーション)を提供出来ます。

For example, a blogging application might provide a feed for each blog,andacomment feed for each blog entry.
例えば、ブログ・アプリケーションは、個々のブログへの記入やコメントの書き込みfeedを提供するでしょう。
A calendar application might allow you to send full-textsearchqueriesusing the GData protocol, and return results in theGDatasyndicationformat.
カレンダー・アプリケーションに、あなたがGDataのプロトコルを使用して送ることも可能です、そしてsyndicationformat(シンジケーション・フォーマット)の結果を戻します。

Because GData is built on basic technologiesHTTP andcommonsyndicationmodelsyou can send GData requests and process the resultingfeeds ina varietyof ways:
GDataは、基礎的なHTTPテクノロジーや共通化されたsyndication（シンジケーション）で造られるので、GDataモデルは様々な処理によって生じるfeedを格納し処理することが出来ます。
traditional syndication aggregators/feedreaders,JavaScript/AJAX-basedclients in a web browser, standalone applications,or anyother approach youlike.
あなたの好む、従来から存在するsyndication（シンジケーション）aggregators/feedreadersReaderやウェブブラウザ内のJavaScript/AJAX-Basedやスタンドアローンアプリケーションからもアプローチ出来ます。
The GData protocol is language-neutral;
GDataプロトコルは言語中立です;
youcan writeaclient in any programming language that lets you issue HTTPrequests andparseXML-based responses.
あなたは、にHTTP要求を出したり、XMLに基づいたレスポンスを解析する為のクライアントを様々なプログラム言語を書くことが出来ます。

Creating and deleting a feed is left up to the service;
feedを作って削除することは、サービスに任せられます
the GData protocol does not provide ways to create or delete a feed.
GDataプロトコルは、feedを作成、削除する方法を提供しません。

The following table lists GData features and indicateswhetherthey'reavailable in other related technologies.
以下のテーブルは、GData機能をリストアップして、それらが他の関連テクノロジーで利用出来るかどうかを示したものです。
For more information about these features, see the Protocoldocument.
これらの機能のより詳細な情報は、プロトコル・ドキュメントを参照してください。

Feature GData Atom* RSS 2.0

Syndication Format（シンジケートフォーマット） Y Y Y

Queries（問い合わせ） Y N N

Updates（更新） Y Y N

Optimistic Concurrency（楽観的な同時実行） Y N N

Authentication(認証) Y N N

*The "Atom" column refers to both the syndication format and the publicationprotocol.
「Atom」のカラムは、syndicationformatおよび公表されたプロトコルを表します。

3．Motivation: Why GData? And why Google?　
動機づけ：なぜGDataなのか?

Google's mission is to organize the world's information and make it universally accessible and useful.
グーグルの使命は、世界の情報を整理し、それを普遍的にアクセス可能で、有用にすることです。
Sometimes making information accessible requires making it available in contexts other than a web browser.
情報をそのようにアクセス可能にすることはそれをウェブ・ブラウザ以外によって利用可能にすることを要求します。
Thus, Google provides APIs to let client software request information outside of a browser context.
このように、Googleは、外部に提供を許可した情報をクライアントのブラウザによって情報を要求させるためにAPIsを提供します。

GData provides a general model for feeds, queries, and results.
GDataは、feeds、クエリー要求、結果の為の一般的なモデルを提供します。
You can use it to send queries and updates to any service that has a GData interface.
GDataインターフェースを持っているすべてのサービスに問い合わせと更新を要求する事が出来ます。

Syndication is an effective and popular method for providing and aggregating content.
Syndicationは、コンテンツを収集するためのポピュラーな方法です。
GData provides a way to expand the types of content that Google can make available through syndication;
GDataは、Googleがsyndicationから入手可能コンテンツを利用し拡張するために方法の提供します。
in particular, it lets you use the syndication mechanism to send queries and receive query results.
特に、それは、あなたが問い合わせを送り、質問を受け取るsyndicationメカニズムを使用することを可能にします。
GData also lets you send data to Google, and update data that Google already has.
GDataは、また、更に、Googleがすでに持っているGoogleデータを送ることを可能にします。

Last modified: Tue May 2 2006
最終更新:2006/03/02 (火)

FeedSchemaItem	AtomRepresentation	RSSRepresentation
Feed Title	/feed/title	/rss/channel/title
Feed ID	/feed/id	/rss/channel/atom:id
Feed HTML Link	/feed/link[@rel="alternate"] `[@type="text/html"]/@href`	/rss/channel/link
Feed Description	/feed/subtitle	/rss/channel/description
Feed Language	/feed/@xml:lang	/rss/channel/language
Feed Copyright	/feed/rights	/rss/channel/copyright
Feed Author	`/feed/author/name /feed/author/email (Requiredincertaincases;seeAtomspecification.)`	/rss/channel/managingEditor
Feed Last Update Date	/feed/updated (RFC3339format)	/rss/channel/lastBuildDate (RFC822format)
Feed Category	/feed/category/@term	/rss/channel/category
Feed Category Scheme	/feed/category/@scheme	/rss/channel/category/@domain
Feed Generator	/feed/generator /feed/generator/@uri	/rss/channel/generator
Feed Icon	/feed/icon	/rss/channel/image/url (unless there's also alogo,inwhichcasetheiconisn'tincludedinthefeed)
Feed Logo	/feed/logo	/rss/channel/image/url

SearchResultFeedSchemaItem	Atom Representation	RSS/OpenSearchRepresentation
Number of Search Results	/feed/opensearch:totalResults	/rss/channel/opensearch:totalResults
Search Result Start Index	/feed/opensearch:startIndex	/rss/channel/opensearch:startIndex
Number of Search Results Per Page	/feed/opensearch:itemsPerPage	/rss/channel/opensearch:itemsPerPage

Entry Schema Item	Atom Representation	RSS Representation
Entry ID	/feed/entry/id	/rss/channel/item/guid
Entry Version ID	Optionally embedded in EditURI (see theOptimistic concurrencysectionofthisdocument).
Entry Title	/feed/entry/title	/rss/channel/item/title
Entry Link	/feed/entry/link	/rss/channel/item/link `/rss/channel/item/enclosure` `/rss/channel/item/comments`
Entry Summary	/feed/entry/summary (Required in certain cases; see Atom specification.)	/rss/channel/item/atom:summary
Entry Content	/feed/entry/content (If no content element, then entry must contain at least one <link rel="alternate"> element.)	/rss/channel/item/description
Entry Author	/feed/entry/author/name /feed/entry/author/email (Required in certain cases; see Atom specification.)	/rss/channel/item/author
Entry Category	/feed/entry/category/@term	/rss/channel/item/category
Entry Category Scheme	/feed/entry/category/@scheme	/rss/channel/item/category/@domain
Entry Publication Date	/feed/entry/published　 (RFC 3339)	/rss/channel/item/pubDate (RFC 822)
Entry Update Date	/feed/entry/updated　　(RFC3339)	/rss/channel/item/atom:updated (RFC 3339)

Parameter	Meaning	Notes
q	Full-text query string	When creating a query, list search termsseparatedbyspaces,inthe form q=term1 term2 term3. 問い合わせを作成する場合、検索用語リストは、スペースで区切った形でq=term1term2term3 (As with all of the query parameter values, the spaces must be URLencoded.) （問い合わせのすべてのパラメータ値のと同じように、スペースは、URLエンコードしなくてはいけません） The GData service returns all entries that match allofthesearchterms(like using AND between terms). GDataサービスは、検索対象用語のすべて一致した結果を返します。(用語間のスペースがANDのように) Like Google's web search, a GData service searchesoncompletewords(andrelated words with the same stem), not substrings. GoogleWebの検索のようなsubstringsではなく、完全一致の単語（先頭から最後まで同じ単語）で検索します。 To search for an exact phrase, enclose the phraseinquotationmarks:q="exactphrase". 正確な句を検索するために、句を引用符で囲んでください。:q="exactphrase" To exclude entries that match a given term, use the form q=-term. ある特定の言葉に一致させる記入項目を除くためには、q=-termのように句の前に-を付けてください。 The search is case-insensitive. 探索はケース無感覚です。 Example: to search for all entries that contain theexactphrase"ElizabethBennet"and the word "Darcy" but don't contain theword"Austen", use the following query: ?q="Elizabeth Bennet" Darcy -Austen 例：正確な句「エリザベス・ベネット」および単語「ダーシー」を含んでいるが、単語「オースティン」を含んでいないすべてのエントリーを探索するために、次のクエリを使用する　?q="ElizabethBennet"Darcy-Austen
/category	Category filter	・List each category as if it were part oftheresource'sURI,in the form /categoryname/this is an exception totheusualname=valueform. ・それが、URIの一部のようにリストしてください。通常の形式の例外として、形式　/categoryname/this ・List all categories before any other query parameters. ・他のqueryparametersの前にすべてのカテゴリをリストアップして下さい。・Precede thefirstcategorywith /-/ to make clear that it's acategory. ・それがカテゴリである事を明確にするために、カテゴリの前に/-/を付加してください。 For example, if Jo's feed has a category for entries aboutFritz,youcouldrequest those entries like this: 例えば、JofeedにFritzについてのカテゴリーを持っていれば、以下のようにそれらのentry項目を要求可能です。・You can query on multiple categories bylistingmultiplecategory parameters, separated by slashes. ・多数のカテゴリーをスラッシュによって分割する事で、多数のカテゴリーリストとして問い合わせする事が出来る。 The GData service returns all entries that match all ofthecategories(like using AND between terms). GDataサービスは、すべてに一致するエントリーをかえす。（AND検索） For example:http://www.example.com/feeds/jo/-/Fritz/Lauriereturns entries that match both categories. 例えば、http://www.example.com/feeds/jo/-/Fritz/Laurieは、両方のカテゴリーと一致する項目を返します。・To do an OR between terms, use a pipecharacter(\|),URL-encoded as %7C. ・(\|)によって用語を分割することで、ORとすることもできる。(\|)は、%7CとしてURLエンコードされる。 For example:http://www.example.com/feeds/jo/-/Fritz%7CLauriereturns entries that match either category. 例えば、http://www.example.com/feeds/jo/-/Fritz%7CLaurieは、どちらかのカテゴリーに一致する項目を返します。・An entry matches a specified category if the entry is inacategory that has a matching term or label, as defined in theAtomspecification. ・そのエントリーが、Atomの仕様で定義されているエントリーと一致する場合には、エントリーが用語かラベルに一致します。 (Roughly, the "term" is the internal string used by the software to identifythecategory, while the "label" is the human-readable string presented to a user in auserinterface.) （大体、用語("term")は、カテゴリーを識別するためにソフトウェアで使用される文字列です。ラベル（"label"）が、ユーザーインタフェースで使用される文字列です。）・To exclude entries that match a given category, usetheform /-categoryname/. ・ある特定のカテゴリーを除外する場合には、/-categoryname/　を使用しなさい。・To query for a category that has a schemesuch as <category scheme="urn:google.com" term="public"/>you must place theschemein curly braces before the category name. ・schemesuchを持っているカテゴリを問い合わせる場合には、<categoryscheme="urn:google.com"term="public"/> カテゴリーの前から｛｝（中括弧）のペアを使ってください。 For example: /{urn:google.com}public. To match acategorythat has no scheme, use an empty pair of curly braces. 例えば、/{urn:google.com}public.　schemeを持たないカテゴリを一致させるには、{}を一組使ってください。 If you don't specify curly braces, then categories in any schemewillmatch. もし、{}を使用しなければ、すべてのschemeと一致するでしょう。・Theabovefeatures can be combined. ・それらの特徴は、組み合わせる事が出来ます。 For example: /A%7C-{urn:google.com}B/-C means (A OR(NOTB)) AND (NOT C). 例えば、/A%7C-{urn:google.com}B/-C　(A OR(NOTB)) AND (NOT C)を意味します。
author	Entry author	The service returns entries where the author name and/oremail address match your query string. サービスは、あなたのquery文字列に一致する、作者名前および／またはEメールアドレスを返します。
alt	Alternative representation type	If you don't specify an alt parameter, the service returnsan Atom feed. もし、altパラメータを使用しなければ、サーバーはAtomfeedを返します。 This is equivalent to alt=atom. これは、alt=atom と同じです。 alt=rss returns an RSS 2.0 result feed. alt=rss　を指定すると、RSS2.0を返します。
updated-min updated-max	Bounds on the entry publication date	Use the RFC 3339 timestamp format. RFC3339タイムスタンプ・フォーマットを使用してください。 For example: 2005-08-09T10:57:00-08:00. 例えば、: 2005-08-09T10:57:00-08:00. Thelower bound is inclusive, whereas the upper bound is exclusive. 上限は、排他的であるが、下限は、包括的である。
start-index	1-based index of the first result to beretrieved	Note that this isn't a general cursoring mechanism. これが一般的なcursoring メカニズムでないことに注意しなさい。 If you first send a query with ?start-index=1&max-results=10 and then send another query with ?start-index=11&max-results=10, the service cannot guarantee that the results are equivalent to ?start-index=1&max-results=20, because insertions and deletions could have taken place in between the two queries. 最初に ?start-index=1&max-results=10 の付加されたクエリを送れば、そしてだれかが、?start-index=11&max-results=10の付加されたクエリを送れば、サービスは、挿入と削除が２つの問い合わせの間に起こったかもしれないので、結果が同じであることを保証しません。
max-results	Maximum number of results to be retrieved	For any service that has a default max-results value (to limit default feed size), you can specify a very large number if you want to receive the entire feed. デフォルトでfeedの制限がある場合、サービス全体のfeedを取得したいと思えば、あなたが指定すればとても大きなSizeを指定することが出来ます
entryID	ID of a specific entry to be retrieved	If you specify an entry ID, you can't specify any other parameters. もし、entry IDをすれば、ほかのパラメータは指定できません。 The form of the entry ID is determined by the GData service. entry IDの形式は、GDataサービスによって定められています。 Unlike most of the other query parameters, entry ID is specified as part of the URI, not as a name=value pair. 他のほとんどのqueryパラメータと違い、entry IDは、name=value のペア形式じゃなくURLの一部として指定されます。 Example:http://www.example.com/feeds/jo/entry1. 例：http://www.example.com/feeds/jo/entry1.

Feature	GData	Atom*	RSS 2.0
Syndication Format（シンジケートフォーマット）	Y	Y	Y
Queries（問い合わせ）	Y	N	N
Updates（更新）	Y	Y	N
Optimistic Concurrency（楽観的な同時実行）	Y	N	N
Authentication(認証)	Y	N	N