GCSGet - Google Cloud Storageからオブジェクトを取得

Google Cloud Storageからオブジェクトを取得してダウンロードします。
ダウンロードするオブジェクトと同じ名前のファイルがすでに存在していた場合は上書きされます。
フォルダーをダウンローすることはできません。
Google Cloud Storageへの認証にはサービスアカウントを使用します。サービスアカウントの使用方法は下記トピック「認証に必要な準備」を参照してください。

■ストリーム情報

入力	フォーマット	すべて
	接続数	無制限
	説明	入力ストリームは使用せず、すべて無視します。
出力	フォーマット	Record
	説明	次のようなフィールド定義のレコードが出力されます。 メタデータを取得したい場合、フィールド名は取得したい情報を「Meta_キー」の形式で指定します。取得できなかった場合nullが出力されます。 フィールド名 データ型 説明 kind String 取得したオブジェクトの種類を出力します。 id String 取得したオブジェクトのIDを出力します。 selfLink String 取得したオブジェクトのURLを出力します。 name String 取得したオブジェクトの名前を出力します。 bucket String 取得したオブジェクトのバケットを出力します。 generation String 取得したオブジェクトのGenerationを出力します。 metageneration String 取得したオブジェクトのMetaGenerationを出力します。 contentType String 取得したオブジェクトのコンテンツタイプを出力します。 timeCreated DateTime 取得したオブジェクトの作成日時を出力します。 updated DateTime 取得したオブジェクトの更新日時を出力します。 storageClass String 取得したオブジェクトのストレージクラスを出力します。 size Integer 取得したオブジェクトのサイズを出力します。 md5Hash String 取得したオブジェクトのMD5ハッシュ値を出力します。 mediaLink String 取得したオブジェクトのメディアリンクを出力します。 owner_entity String 取得したオブジェクトのオーナーのエンティティを出力します。 owner_entityId String 取得したオブジェクトのオーナーのエンティティIDを出力します。 crc32c String 取得したオブジェクトのCRC32Cを出力します。 etag String 取得したオブジェクトのETagを出力します。 Meta_[キー] 取得したオブジェクトのメタデータを出力します。 filePath String ダウンロードしたファイルの絶対パスを出力します。

■コンポーネントプロパティ

名前	プロパティ型	マッピング	説明
コネクションを使用	boolean	-	接続先に以下のコネクション名を使用するかどうか選択します。 はい [true] - 以下のコネクション名で指定された接続情報を使用します。 いいえ [false] - コネクション情報以下のプロパティを使って接続を行います。
コネクション名	connection	-	コネクションを使用が「はい」の場合に、GCPコネクションを指定します。 コネクションペインまたは管理コンソールにて作成されたGCPコネクションを選択します。
コネクション情報	group	-	コネクションを使用プロパティが「いいえ」の場合に使用されるプロパティ群です。
メールアドレス	string	入力＆出力	Google Developer Consoleから取得したサービスアカウントのメールアドレスを設定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。
証明書のエイリアス	string	入力＆出力	サービスアカウント認証用の証明書のエイリアスを設定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。
アプリケーション名	string	入力＆出力	Google Cloud Storageのアプリケーション名を設定します。 Google Cloud Platformのプロジェクト名ではなく、アプリケーションを区別するための名前です。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。
タイムアウト（秒）	int	入力＆出力	リクエスト時およびコネクション接続時のタイムアウトまでの時間を秒単位で指定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。
プロキシ設定を使用	boolean	-	管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。 プロキシの認証には対応していません。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 はい [true] - プロキシ設定を使用します。 いいえ [false] - プロキシ設定を使用しません。
バケット名	string	入力＆出力	オブジェクトを取得するバケットの名前を指定します。
オブジェクト名	string	入力＆出力	取得するオブジェクトの名前を指定します。
保存先ファイルパス	remoteFile	入力＆出力	取得したファイルを保存するパスを指定します。
ファイルパスの詳細設定	group	-	ファイルパスの詳細設定を行うプロパティ群です。
相対パスの起点	pathResolver	-	相対パス指定の場合にベースフォルダーを指定します。 プロジェクトフォルダー [Relative] プロジェクトファイルと同じフォルダーを起点にします。 ホームフォルダー [ProjectOwner] ユーザーのホームフォルダーを起点にします。 実行ユーザーのホームフォルダー [ExecuteUser] 実行ユーザーのホームフォルダーを起点にします。
絶対パスを許可	boolean	-	絶対パスを許可するかどうか選択します。
「..」を許可	boolean	-	上のフォルダへ移動する記述に「..」を許可するかどうか選択します。

■トランザクション処理

コミット	何もしません。
ロールバック	何もしません。

■エラー処理

タイプ	パラメーター	エラー処理フロー へのストリーム	エラー コード	説明
汎用	なし	コンポーネントの入力ストリーム	1	保存先ファイルパスが不正だった場合
			2	通信に失敗した場合
			3	オブジェクトへのアクセス権がなかった場合
			4	証明書の取得に失敗した場合
			5	プロパティが不正だった場合
			7	出力ストリームのフィールドのデータ型の定義が不正だった場合
オブジェクトが無い	なし	コンポーネントの入力ストリーム	6	オブジェクトが存在しない場合

■認証に必要な準備

Google Cloud Storage系コンポーネントを使用するには、Google Developer Consoleからサービスアカウントを作成して認証情報を取得し、管理コンソールで設定する必要があります。

1. Google Developer Consoleの「認証情報」でサービスアカウントを追加する
2. P12形式の証明書を選択してダウンロードする
3. 管理コンソールでP12証明書をユーザーの証明書としてインポートする
4. サービスアカウントのメールアドレスとインポートした証明書をコンポーネントの接続情報に設定する

■動作に必要な設定

Google Cloud Storage系コンポーネントを使用するには、Google APIs Client Libraries for Javaが必要です。

1. Assembly for the Google APIs Client Library for Javaからgoogle-api-client-assembly-1.31.2-1.31.2.zipファイルをダウンロードしてください。
2. ダウンロードしたzipファイルを解凍し、次のjarファイルを[DATA_DIR]/system/lib/userlibフォルダーにコピーしてください。
   
   • google-api-client-1.31.2.jar
   • google-http-client-1.38.1.jar
   • google-http-client-jackson2-1.38.1.jar
   • google-oauth-client-1.31.4.jar
   • grpc-context-1.22.1.jar
   • guava-30.1-android.jar
   • opencensus-api-0.24.0.jar
   • opencensus-contrib-http-util-0.24.0.jar
3. Could Storage JSON API Libraryのダウンロードページから最新版のjarファイルをダウンロードしてください。（最新版の詳細ページのFilesという項目にjarファイルのダウンロードリンクがあります）
4. ダウンロードした次のjarファイルを[DATA_DIR]/system/lib/userlibフォルダーにコピーしてください。
   
   • google-api-services-storage-v1-rev[version]-[version].jar

■バケットとオブジェクトの設定画面

コンポーネントをダブルクリックするか、右クリックメニューの「Google Cloud Storage Browser」を実行することで、コンポーネントに設定されている接続情報を使用して設定画面が開きます。
この画面ではバケット名とオブジェクト名の設定とバケットの新規作成、そしてバケットとオブジェクトの削除を行うことができます。
まず最初に「プロジェクト」にプロジェクトIDかプロジェクトのナンバーを入力してから「バケットリスト」ボタンをクリックしてください。

「バケット」ツリーリスト

バケットとオブジェクトのツリーリストが表示されます。
このリストの中からコンポーネント設定するバケットとオブジェクトを選択します。

「プロジェクト」

バケットのプロジェクトを指定します。
プロジェクトのIDかナンバーを指定してください。プロジェクト名には対応していません。
コンポーネントのバケット名が指定されている場合、そのバケットが所属するプロジェクトのナンバーが表示されます。

「バケットリスト」ボタン

指定したプロジェクトのバケットリストを表示します。

バケット名

選択したバケットの値が表示されます。

オブジェクト名

選択したオブジェクトの値が表示されます。

「バケットを作成」ボタン

バケットを作成するためのダイアログが表示されます。

「バケットを削除」ボタン

「バケット」ツリーリストで選択されているバケットをサーバーから削除します。

「オブジェクトを削除」ボタン

「バケット」ツリーリストで選択されているオブジェクトをサーバーから削除します。

属性情報

選択されているバケットまたはオブジェクトの属性情報が表示されます。
ファイル内容はUTF-8で表示します。それ以外のエンコーディングではうまく表示できない場合があります。

「OK」ボタン

リストで選択されたバケットとオブジェクトの情報をコンポーネントのバケット名とオブジェクト名プロパティに設定します。

「キャンセル」ボタン

このダイアログを閉じます。
コンポーネントのバケット名とオブジェクト名プロパティに変更はありません。