Google Document List API Ver.3.0でできなくなったこと

現在、Google Document List API Ver.3.0が公開されています。Ver.3.0では旧バージョンではできなかったアップロードドキュメントの検索ができるようになっているなど基本的に機能が向上しているのですが、Ver. 2.0ではできていたことができなくなっている物もあります。

その一つとして「フォルダ名を指定してドキュメントを検索する」ことが挙げられます。

Ver.2.0では以下の様にURLにcategoryパラメータを指定することで特定の名称のフォルダ内のドキュメントを検索することが可能でした。

https://docs.google.com/feeds/documents/private/full?category=collection_name

もっとも上記のクエリでは同名のフォルダが複数存在する場合、その全てが検索の対象となってしまうので微妙と言えば微妙なのですが。

これに対し、Ver.3.0ではこのcategoryパラメータによるフォルダの絞り込みができなくなっています。Ver.3.0において特定のフォルダ内のドキュメントを検索する場合、以下の様に対象フォルダのIDをURLに指定する必要があります。

https://docs.google.com/feeds/default/private/full/folder%3Acollection_id/contents 

IDによる指定なのでピンポイントで特定のフォルダ内を検索できるのですが、当然ながら対象のIDを事前に把握する必要があります。その為旧バージョンのAPIでcategoryパラメータによるフォルダ指定を行っているような実装の場合、実装の修正が必要となってきます。

About these ads