この記事は 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 の基準時刻タイプを指定します:
|
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 | 検索するフォルダ名。これは以下のうちのひとつ:
|
!annotation | boolean | annotation で指定されたアノテーションにマッチする項目を含めるかどうかを指定します。true の場合、指定されたアノテーションをもつ項目は捨てられます。 |
annotation | string | 検索時にマッチさせるアノテーション。 |
uri | string | URI。 |
uriIsPrefix | boolean | false の場合、uri は完全一致しなければなりません(デフォルト)。true の場合、指定された URI で始まるものがマッチします。 |
以下の属性は結果をより細かく制御するために使用されます。
オペレータ | タイプ | 説明 |
---|---|---|
OR | 論理 OR 演算子。 | |
group | ||
sort | unsigned short | 結果のソート方法。
|
sortingAnnotation | string | アノテーションでソートするときに使用するアノテーション。 |
type | unsigned short | 結果のタイプ。
|
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 | データベースをクエリする際に使用する検索のタイプ。このアトリビュートはクエリノードに対してのみ有効。単純なフォルダクエリでは無視される。
|