Places query URIs

この記事は place URI を生成するときに使用できるパラメータについて説明します。これらの URI は Places のクエリを実行します。

place URI をブックマークとして使用できます。例えば、ツールバーを右クリックして「新しいブックマーク」をクリックすると、そこに place URI を入力できます。それはツールバーに新しいクエリを生成し、クリックするとクエリーの結果を含むポップアップが現れます。

以下の place URI は Firefox 3を最初に起動したときに生成されるデフォルトのスマートブックマークセットの「よく見るページ」スマートブックマークを実現します。

place:queryType=0&sort=8&maxResults=10

このクエリで使用されているパラメータは以下のとおりです：

queryType=0

これはクエリはユーザの履歴だけに適用されブックマークには適用されないことを示します。

sort=8

sort はクエリ結果が訪問回数に基づいて降順にソートされて表示されることを示します。言い換えると、最も多く訪問したものが最初に、少ないものが最後になります。

maxResults=10

このパラメータはクエリの結果は最大で10個になることを示します。

このクエリを今日訪問したものだけを表示するようにしたければ、以下のように変更します:

place:queryType=0&sort=8&maxResults=10&beginTimeRef=1&beginTime=0

ここで追加されたパラメータは:

beginTimeRef=1

後に続く beginTime パラメータは今日の午前0時からの相対時間であることを示します。

beginTime

検索開始時刻を午前0時からの相対時間（マイクロ秒）で指定します。この値に0を指定すると、今日訪問したすべてのサイトを対象とすることになります。

パラメータ	タイプ	説明
beginTime	unsigned long	開始時刻をマイクロ秒で指定する。
beginTimeRef	unsigned long	beginTime の基準時刻タイプを指定します: 0 時刻は January 1, 1970 GMT からの相対時刻です。デフォルトです。 1 今日の午前0時からの相対時刻です。これは「今日」を指定するのに役に立ちます。 2 現在時刻からの相対時刻です。
endTime	unsigned long	終了時刻をマイクロ秒で指定します。
endTimeRef	unsigned long	endTime の基準時刻タイプを指定します。値は beginTime と同じです。
terms	string	検索する単語。
minVisits	long	結果を訪問回数の最小値をもとにフィルタリングします。-1（デフォルト）を指定するとすべてを返し、それ以外の数値を指定すると訪問回数がそれ以上のものが含まれます。
maxVisits	long	結果を訪問回数の最大値をもとにフィルタリングします。結果には指定された数値よりも小さい訪問回数のものだけが含まれます。-1（デフォルト）を指定すると最大訪問回数によるフィルタリングを行いません。
onlyBookmarked	boolean	true の場合、結果にはブックマークされたものだけが含まれます。
domainIsHost	boolean	true の場合、domain は完全に一致する必要があります。そうでない場合、domain の最後の部分が一致するかがチェックされます。
domain	string	ホストまたはドメイン名にマッチするものを検索します。詳細は domainIsHost を参照してください。
folder	string	検索するフォルダ名。これは以下のうちのひとつ: PLACES_ROOT Places のルートフォルダ。 BOOKMARKS_MENU ブックマークメニュー。 TOOLBAR ブックマークツールバー。 TAGS タグ。 UNFILED_BOOKMARKS 未整理のブックマーク。
!annotation	boolean	annotation で指定されたアノテーションにマッチする項目を含めるかどうかを指定します。true の場合、指定されたアノテーションをもつ項目は捨てられます。
annotation	string	検索時にマッチさせるアノテーション。
uri	string	URI。
uriIsPrefix	boolean	false の場合、uri は完全一致しなければなりません（デフォルト）。true の場合、指定された URI で始まるものがマッチします。

以下の属性は結果をより細かく制御するために使用されます。

オペレータ	タイプ	説明
OR		論理 OR 演算子。
group
sort	unsigned short	結果のソート方法。 0 ブックマークの並び順。 1 タイトルでソート（A-Z） 2 タイトルでソート（Z-A） 3 訪問日でソート（新しいものが最後） 4 訪問日でソート（新しいものが最初） 5 uri でソート（A-Z） 6 uri でソート（Z-A） 7 訪問回数でソート（昇順） 8 訪問回数でソート（降順） 9 キーワードでソート（A-Z） 10 キーワードでソート（Z-A） 11 追加した日付でソート（新しいものが最後） 12 追加した日付でソート（新しいものが最初） 13 最終更新日でソート（新しいものが最後） 14 最終更新日でソート（新しいものが最初） 17 タグでソート（昇順） 18 タグでソート（降順） 19 アノテーションでソート（昇順） 20 アノテーションでソート（降順）
sortingAnnotation	string	アノテーションでソートするときに使用するアノテーション。
type	unsigned short	結果のタイプ。 0 URI(範囲内に訪問した各 URI の一つ）。 1 訪問（ページが訪問されるたびに1回：これはしばしば一つの URI に対して複数の結果を返す）。 2 完全な訪問（"visit"と似ているが、すべての属性を返す）。 3 日付クエリ（指定された日付範囲の結果を返す）。 4 サイトクエリ（指定されたホスト内の最後の訪問を返す）。 5 日付＋サイトクエリ（指定された日付範囲に訪問したホストを返す）。 6 タグクエリ（指定されたタグを持つブックマークのリストを返す）。 7 タグコンテナ（指定されたタグを持つブックマークを返す。同一の uri の場合は最後に修正されたもの。クエリに folder=tag_folder_id が必要。）
excludeItems	boolean	true の場合、すべての URI とセパレータはブックマーククエリの結果から除外され、フォルダとクエリだけ返す。false の場合（デフォルト）、すべての項目を返す。
excludeQueries	boolean	true の場合、クエリは結果から除外されるが、ブックマークフォルダの symlink のような単純なフォルダクエリは含まれる。false の場合（デフォルト）、クエリは結果に含まれる。
excludeReadOnlyFolders	boolean	true の場合、読み込み専用フォルダは結果から除外される。これは実際のフォルダの結果のノードがその親フォルダ内に現れる場合にだけ有効である。デフォルトは false。
excludeItemIfParentHasAnnotation	string	親がこの値のアノテーションを持つアイテムはクエリの結果から除外される。このパラメータは履歴に対しては無視される。例えば、"livemark/feedURI" を指定することによってライブブックマークのエントリを除外できる。
expandQueries	boolean	true の場合、place の URI は結果の中にコンテナとして現れ、そのコンテンツは保存されたクエリの結果で満たされる。excludeQueries が true の場合は無効になる。デフォルトは false であり、place の URI は通常のアイテムとして現れる。
originalTitle	string	オリジナルのページタイトルを復元する。
includeHidden	boolean	true の場合、iframe のコンテンツや画像など通常の履歴クエリでは表示されないアイテムを結果に含める。デフォルトは false。
showSessions	boolean	true の場合、セッション情報が履歴アイテムのグルーピングのために利用される。これは日付によるソートの場合だけ有効である。デフォルトはfalse。
resolveNullBookmarkTitles	boolean	trueの場合、可能であれば、タイトルが null のブックマークは履歴からページタイトルを取ってくる。これは空タイトルのブックマークには影響しない。デフォルトは false。
applyOptionsToContainers
maxResults	unsigned long	結果の最大数。タイトルでソートする場合は無効。0 はすべての結果を返すことを意味する。
queryType	unsigned short	データベースをクエリする際に使用する検索のタイプ。このアトリビュートはクエリノードに対してのみ有効。単純なフォルダクエリでは無視される。 0 履歴 1 ブックマーク 2 履歴とブックマークの両方

• Querying Places