Google Drive - ファイルまたはフォルダの検索アクション
このアクションは、検索条件に一致するファイルまたはフォルダのリストを取得します。
Google Driveのファイルまたはフォルダの検索アクション
入力
| 入力フィールド | 説明 |
|---|---|
| ファイルまたはフォルダ | ファイルまたはフォルダのどちらを検索するかを選択します。 |
| フォルダ | 検索範囲をこのフォルダ内に絞り込みます。 サブフォルダ内の一致するファイルとフォルダは含まれません。 マイドライブ全体を検索するには空白のままにします。 |
| 名前 | 指定した名前と部分一致する名前のファイルまたはフォルダを検索します。 |
| 変更日時が次の日時より後 | この日付より後に変更されたファイルを検索します。 |
| ゴミ箱に移動済みのファイルですか | ゴミ箱に移動済みのファイルを検索するには、はいに設定します。 |
| スター付きファイルですか | スター付きのファイルを検索するには、はいに設定します。 |
| 所有者のメール | このユーザーに属するファイルまたはフォルダを検索します。 |
| 編集者のメールアドレス | このユーザーが編集権限を持つファイルまたはフォルダを検索します。 |
| 閲覧者のメールアドレス | このユーザーが閲覧権限を持つファイルまたはフォルダを検索します。 |
| 自分と共有されていますか | 接続済みユーザーと共有されているファイルまたはフォルダを検索します。 |
| クエリ | 正確なクエリで検索結果をフィルタリングします。 サポートされている構文については、Google Driveのドキュメントを参照してください。 名前、変更日時が次の日時より後、ゴミ箱に移動済みのファイルですか、スター付きファイルですか、所有者のメールアドレス、編集者のメールアドレス、閲覧者のメールアドレス、または自分と共有されていますかでフィルタリングするには、適切な構文でクエリフィールドを使用するか、このテーブルの前述のフィールドを使用できますが、両方は使用できません。 同じエントリを2回追加すると、クエリエラーが発生します。 たとえば、名前フィールドに入力する場合は、nameクエリを入力しないでください。 |
| 次のページトークン | 検索結果の次のページを取得するには、前回の検索リクエストのnextPageTokenを指定します。 |
| ページサイズ | 1ページあたりに返すファイルまたはフォルダの最大数。 ファイルリストの末尾に到達する前でも、部分的または空の結果ページが返されることがあります。 指定できる値は1～100です。両端の値を含みます。 デフォルトは100です。 |
出力
Google Drive APIでは、folderとfileという用語は同じ意味で使用されることに注意してください。 folderは技術的には特殊なfileです。 そのため、項目名または項目の説明でfileが言及されている場合は、folderにも適用されます。
| 出力フィールド | 説明 |
|---|---|
| 次のページトークン | 検索結果の次のページを取得するには、このトークンを次ページトークンフィールドに指定します。 |
| 未完了の検索 | 検索が未完了かどうかを示します。 |
| ファイル | 検索で見つかったファイルまたはフォルダのリスト。 各ファイル/フォルダには、リストサイズおよびリストインデックスに加えて、次の出力フィールドが含まれます:
|
| 親 | ファイルを含む親フォルダのリスト。 リスト内の各親フォルダには、リストサイズおよびリストインデックスに加えて、次の出力フィールドが含まれます:
|
| バージョン | ファイルのバージョン番号。 これは、ユーザーに表示されない変更も含め、サーバー上でファイルに加えられたすべての変更を反映します。 |
| ウェブコンテンツリンク | ブラウザでファイルのコンテンツをダウンロードするためのリンク。 これは、Google Drive内のバイナリコンテンツを含むファイルでのみ使用できます。 |
| ウェブビューリンク | ブラウザで関連するGoogleエディタまたはビューアでファイルを開くためのリンク。 |
| アイコンリンク | ファイルのアイコンへの静的な未認証リンク。 |
| サムネイルリンク | 利用可能な場合、ファイルのサムネイルへの短期間有効なリンク。 通常、数時間程度有効です。 リクエスト元のアプリがファイルのコンテンツにアクセスできる場合にのみ入力されます。 |
| 自分が閲覧済み | このユーザーがファイルを閲覧したかどうかを示します。 |
| 自分が閲覧した時刻 | このユーザーが最後にファイルを閲覧した時刻（RFC 3339日時）。 |
| 作成時刻 | ファイルが作成された時刻（RFC 3339日時）。 |
| 変更時刻 | 誰かが最後にファイルを変更した時刻（RFC 3339日時）。 |
| 自分が変更した時刻 | このユーザーが最後にファイルを変更した時刻（RFC 3339日時）。 |
| 共有ユーザー | 該当する場合、リクエスト元ユーザーとファイルを共有したユーザー。 各ユーザーには、次の出力フィールドが含まれます:
|
| 所有者 | ファイルの所有者のリスト。 現在、複数の所有者を持つことができるのは一部のレガシーファイルのみです。 共有ドライブのファイルには入力されません。 各所有者には、リストサイズおよびリストインデックスに加えて、次のフィールドが含まれます:
|
| 共有済み | ファイルが共有されているかどうかを示します。 共有ドライブのファイルには入力されません。 |
| 自分が所有 | ユーザーがファイルを所有しているかどうかを示します。 共有ドライブのファイルには入力されません。 |
| 閲覧者はコンテンツをコピー可能 | 閲覧アクセス権を持つユーザーがファイルのコンテンツをコピーできるかどうかを示します。 |
| 編集者は共有可能 | 編集アクセス権を持つユーザーがファイルを共有できるかどうかを示します。 共有ドライブのファイルには入力されません。 |
| 元のファイル名 | 利用可能な場合はファイルの元のファイル名。利用できない場合は名前フィールドの元の値。 これは、Google Drive内のバイナリコンテンツを含むファイルでのみ使用できます。 |
| 完全なファイル拡張子 | 名前フィールドから抽出された完全なファイル拡張子。 連結された複数の拡張子を含む場合があります（例: tar.gz）。 これは、Google Drive内のバイナリコンテンツを含むファイルでのみ使用できます。 名前フィールドが変更されると自動的に更新されますが、新しい名前に有効な拡張子が含まれていない場合でもクリアされません。 |
ファイル拡張子 完全なファイル拡張子の最後の構成要素（例: gz）。 これは、Google Drive内のバイナリコンテンツを含むファイルでのみ使用できます。 | |
| MD5チェックサム | ファイルのコンテンツのMD5チェックサム。 これは、Google Drive内のバイナリコンテンツを含むファイルにのみ適用されます。 |
| サイズ | ファイルのコンテンツのサイズ（バイト単位）。 これは、Google Drive内のバイナリコンテンツを含むファイルにのみ適用されます。 |
| 使用済み割り当てバイト数 | ファイルによって使用されたストレージ割り当てのバイト数。 これには、ヘッドリビジョンのほか、永久保持が有効になっている以前のリビジョンが含まれます。 |
| ヘッドリビジョンID | ファイルの最新バージョンのID。 これは現在、Google Drive内のバイナリコンテンツを含むファイルでのみ使用できます。 |
Last updated: