Application Integration でサポートされているコネクタをご覧ください。

ドライブ - List タスク

ドライブ - 一覧表示タスクを使用すると、Google ドライブ アカウントに保存されているファイルやフォルダの検索と取得ができます。

Google ドライブは、共同作業の共有ファイルとフォルダをクラウドに保存し、アクセスするための個人用のストレージを提供するクラウド ファイル ストレージ サービスです。

準備

ドライブ - List タスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。

  1. Google Drive API（drive.googleapis.com）を有効にします。

    Google Drive API を有効にします。

  2. 認証プロファイルを作成します。Application Integration では、認証プロファイルを使用して、ドライブ - List タスクの認証エンドポイントに接続します。

    サービス アカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。

ドライブ - List タスクを構成する

  1. Google Cloud コンソールで [Application Integration] ページに移動します。

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。

    [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

  3. 既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。

    新しい統合を作成する場合:

    1. [統合の作成] ペインで名前と説明を入力します。
    2. 統合のリージョンを選択します。
    3. 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
    4. [作成] をクリックします。

    統合エディタで統合が開きます。

  4. 統合エディタのナビゲーション バーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
  5. 統合デザイナーで、[Drive - List] 要素をクリックして配置します。
  6. デザイナーで [Drive - List] 要素をクリックして、[Drive - List] タスク構成ペインを表示します。
  7. [認証] に移動し、使用する既存の認証プロファイルを選択します。

    省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ 新しい認証プロファイル] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。

  8. [タスク入力] に移動し、次の [タスク入力パラメータ] テーブルを使用して、目的の入力フィールドを構成します。

    入力フィールドの変更は自動的に保存されます。

タスクの入力パラメータ

次の表に、ドライブ - List タスクの入力パラメータを示します。

プロパティ データ型 説明
Corpora 文字列 corpora 内のファイルを検索するオプションのパラメータ。
DriveId 文字列 Google 共有ドライブの ID。
IncludeItemsFromAllDrives ブール値 検索結果に個人用ドライブと共有ドライブ アイテムの両方を含める場合は、値を true に設定します。

デフォルト値: false。
IncludeLabels 文字列 レスポンスの labelInfo 部分に含まれるラベル ID のカンマ区切りのリスト。ラベル ID の詳細については、ラベルの概要をご覧ください。
IncludePermissionsForView 文字列 published を指定します。詳しくは、ファイル、フォルダ、ドライブを共有するをご覧ください。
OrderBy 文字列 ファイルを並べ替える順序。各キーはデフォルトで昇順に並べ替えられます。詳細については、files.list メソッドをご覧ください。

有効な値は次のとおりです。

  • createdTime
  • folder
  • modifiedByMeTime
  • modifiedTime
  • name
  • name_natural
  • quotaBytesUsed
  • recency
  • sharedWithMeTime
  • starred
  • viewedByMeTime
PageSize 整数 ページごとに返されるファイルの最大数。

有効な値は 1 から 1000 です。

デフォルト値: 100。
PageToken 文字列 前の ドライブ - List タスクを続行するためのトークン。この値は、前のレスポンスの nextPageToken の値に設定します。
Q 文字列 ファイル結果をフィルタリングするためのクエリ。詳しくは、ファイルを検索するをご覧ください。
Spaces 文字列 コーパス内でクエリするスペースのカンマ区切りのリスト。

指定できる値は drive と appDataFolder です。
SupportsAllDrives ブール値 リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしている場合は、値を true に設定します。

デフォルト値: false。

タスク出力

ドライブ - List タスクは、ファイルのリストを含むレスポンス出力を返します。出力例を次に示します。

  {
    "nextPageToken": string,
    "kind": string,
    "incompleteSearch": boolean,
    "files": [
      {
        object (File)
      }
    ]
  }

エラー処理方法

タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式と、さまざまな種類のエラー処理方式の詳細については、エラー処理方法をご覧ください。

割り当てと上限

割り当てと上限については、割り当てと上限をご覧ください。

次のステップ