Google ドライブの [ファイル/フォルダーを検索] アクション
- 最終更新日2023/11/20
Google ドライブの [ファイル/フォルダーを検索] アクション
[ファイル/フォルダーを検索] アクションを使用すると、Google ドライブの特定のディレクトリにあるファイルやフォルダーを検索することができます。
設定
- [接続] アクションで使用した同じユーザー名を入力します。
- 次のいずれかのオプションを選択します。
- ファイルを検索するには、[ファイル] をクリックします。
- フォルダーを検索するには、[フォルダー] をクリックします。
- [ファイル] または [フォルダー] のいずれかを選択した後、ソース フォルダー パスまたはソース フォルダー ID を指定することができます。
- ソース フォルダー パス: 検索するファイルまたはフォルダーがあるフォルダーを指定します。たとえば、検索するファイルやフォルダーが Google Drive の Home/Accounts フォルダー内にある場合は、ソース フォルダー パスとして「Home/Accounts」と入力します。検索するファイルやフォルダーが Home というフォルダーの中にある場合は、スラッシュを入れずに単に「Home」と入力します。対象のファイルまたはフォルダーがルート ディレクトリ (My Drive) にある場合は、ソース フォルダー パスとして「root」と入力します。
- ソース フォルダー ID: 検索するファイルまたはフォルダーがあるフォルダーの ID を入力します。同じ名前のフォルダーが複数ある場合、フォルダー ID を使用すると、特定のフォルダー内のファイルやフォルダーを検索することができます。
- [タイプを照合] から、以下のいずれかのオプションを選択できます。
- 指定されたファイル名またはフォルダー名と完全に一致する結果が API から返されるようにするには、[完全一致] を選択します。
- 指定されたファイル名またはフォルダー名に部分的に一致する結果が API から返されるようにするには、[含む] を選択します。
- [ファイル/フォルダー名] に、検索するファイルまたはフォルダーの名前を指定します。Google ドライブ内でファイルに拡張子が表示されている場合は、拡張子も含めてください。
- 「ファイル/フォルダーを検索」API から、一致したファイルに関する情報を含むディクショナリが返されます。このディクショナリには NumberOfFiles というキーが含まれています。これは、一致したファイルの数を示します。ディクショナリには、一致したファイルの数に応じて、File1、File2 といった名前のキーも含まれます。これらのキーには、ファイル名やファイル ID などの情報が JSON 形式で格納されています。以下は、「ファイル/フォルダーを検索」API 呼び出しによって返されるディクショナリの例です。
次のいずれかのオプションを選択して、結果を取得できます。{NumberOfFiles,1},{File1,{"fileName":"contacts","fileId":"171yBUzqH80ZW_KLEp23DwebzkCdDZgnGFWBzB6K9kco"}}
- 複数の変数: 各キーを変数にマッピングする場合は、このオプションを使用します。
- ディクショナリ: また、サブタイプを [任意] としたディクショナリ変数を作成し、API から返されたディクショナリをその変数に格納することもできます。その後 JSON 文字列を解析することで、ファイル名、ファイル ID、フォルダー名、フォルダー ID などの情報を取得することができます。詳細については、「Google ドライブ パッケージから [ファイル/フォルダーを検索] アクションを使用する例」をご覧ください。