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

Firestore - Document Get タスク

プレビュー

この機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 pre-GA の機能は「現状有姿」で利用できますが、サポートが制限される場合があります。 詳しくは、リリース ステージの説明をご覧ください。

Firestore - Document Get タスクを使用すると、単一の Firestore ドキュメントの内容を取得できます。デフォルトでは、Firestore - Document Get タスクは Firestore データベースから最新のドキュメント スナップショットを取得します。

Firestore は、自動スケーリングと高性能を実現し、アプリケーション開発を簡素化するように構築された NoSQL ドキュメント データベースです。

準備

Firestore - Document Get タスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。

1. Cloud Firestore API（firestore.googleapis.com）を有効にします。

   Cloud Firestore API を有効にする

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

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

Firestore - Document Get タスクを構成する

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

   Application Integration に移動

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

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

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

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

   1. [統合の作成] ペインで名前と説明を入力します。
   2. 統合のリージョンを選択します。
      注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
   3. 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
      注: サービス アカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
   4. [作成] をクリックします。

   統合デザイナーで統合が開きます。

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

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

8. [Task Input] に移動し、次の「タスクの入力パラメータ」の表を使用して表示される入力フィールドを構成します。

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

タスクの入力パラメータ

次のテーブルに、Firestore - Document Get タスクの入力パラメータを示します。

プロパティ	データ型	説明
Region	文字列	Firestore データベースのロケーション。例: us-central1
ProjectsId	文字列	Google Cloud プロジェクト ID。
DatabasesId	文字列	Firestore データベースの ID。
DocumentsId	文字列	Firestore ドキュメントへのパスまたは場所。

タスク出力

Firestore - Document Get タスクは、ドキュメント データを base64 エンコード形式で返します。出力文字列を取得するには、Base64 エンコード値をデコードする必要があります。

ヒント: Linux や macOS では base64 コマンド、Windows では Base64.exe コマンドを使用して、データを base64 でエンコードまたはデコードできます。プログラミング言語とスクリプト言語には通常、base64 エンコード用のライブラリが含まれています。コマンドラインの例については、Cloud Text-to-Speech のドキュメントのデコード base64 をご覧ください。

エラー処理方式

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

次のステップ

1. エッジとエッジの条件を追加する。
2. インテグレーションをテストして公開する。
3. トリガーを構成する。
4. データ マッピング タスクを追加する。
5. Google Cloud サービス向けのすべてのタスクを確認する。