GET /search APIでは、APIによって返された結果にフィルタをかけるためのさまざまな方法がサポートされています。
コンテンツタイプによるフィルタ
デフォルトでは、名前、説明、ファイルコンテンツ、タグ、またはコメントが指定されたクエリと一致する項目が返されます。content_typesパラメータを設定すると、定義したコンテンツタイプのクエリに一致する項目のみに検索を絞り込むことができます。
| コンテンツタイプ | |
|---|---|
name | nameフィールドで定義されている、項目の名前。 |
description | descriptionフィールドで定義されている、項目の説明。 |
file_content | ファイルの実際のコンテンツ。 |
comments | ファイルまたはフォルダに対するコメントのコンテンツ。 |
tags | tagsフィールドで定義されている、項目に適用されるタグ。 |
日付によるフィルタ
デフォルトでは、指定した日付に作成されたファイルと指定した日付に更新されたファイルが返されます。ファイルまたはフォルダが最後に更新された日付でも、ファイルまたはフォルダが作成された日付でも結果にフィルタをかけることができます。| クエリパラメータ | |
|---|---|
created_at_range | 結果を返すcreated_atの日付の範囲を定義します。上限または下限を空にすると、範囲を期限なしにすることができます。 |
updated_at_range | 結果を返すupdated_atの日付の範囲を定義します。上限または下限を空にすると、範囲を期限なしにすることができます。 |
ファイル拡張子によるフィルタ
デフォルトでは、さまざまな種類のファイル拡張子の項目が返されます。file_extensionsクエリパラメータを使用すると、指定した1つ以上のファイル拡張子のファイルのみが返されるよう、検索結果にフィルタをかけることができます。
ファイルサイズによるフィルタ
デフォルトでは、さまざまなファイルサイズの項目が返されます。size_rangeクエリパラメータを使用すると、指定したファイルサイズを超えないファイルのみが返されるよう、検索結果にフィルタをかけることができます。
ファイルタイプによるフィルタ
デフォルトでは、ファイル、フォルダ、およびウェブリンクがすべて返されます。結果をそのうちの1つだけに絞り込むには、typeクエリパラメータをfile、folder、web_linkのいずれかに設定します。
メタデータによるフィルタ
関連付けられたメタデータを使用して検索結果にフィルタをかけることも、メタデータのみに基づいてすべての検索を実行することもできます。どちらの場合もmdfiltersクエリパラメータを使用します。
メタデータフィルタの詳細を確認する
所有者によるフィルタ
デフォルトでは、項目の所有者に関係なく、認証済みユーザーがアクセスできるすべての項目が返されます。特定のユーザーが所有する項目のみに絞り込むには、owner_user_idsクエリパラメータを使用します。
親フォルダによるフィルタ
デフォルトでは、ユーザーがアクセスできる任意のフォルダ内のすべての項目が返されます。特定のフォルダ内の項目のみに結果を絞り込むには、ancestor_folder_idsクエリパラメータを使用します。