Actions SDK と Actions Builder のクイックスタートガイド

このガイドでは、以下を使用してアクションを構築する環境を設定する手順について説明します。 Actions SDK と Actions Builder の両方をサポートしています。次のタスクを行います。

Node.js をインストールする: Node.js を使用するには、このランタイム環境が必要です。フルフィルメントライブラリを使用します。
Firebase CLI をインストールする: このコマンドラインツールを使用すると、 Interactive Canvas 用のウェブアプリなどの Firebase の依存関係をデプロイし、 Firebase Hosting
gactions コマンドラインツールをインストールする: Actions を使用して開発する場合のアクションパッケージを作成、管理、デプロイするには、追加します。
Actions プロジェクトを作成する: Actions プロジェクトは論理コンテナ説明しましたまず Actions Console でアカウントを作成し、構築を開始できます。
サンプルを初期化してデプロイする: このシンプルなサンプルでは、 Interactive Canvas を利用したアクションの構築を開始しました。

このクイックスタートを完了したら、Google Cloud コンソールと Actions Builder のウェブエクスペリエンスを向上させるためのツールです。

Node.js と Firebase CLI をインストールする

Node.js に従って Node.js をダウンロードしてインストールするドキュメントをご覧くださいNode.js のインストールもこれにより、npm を使用して Firebase CLI をインストールし、会話フルフィルメントをローカルに実装できます。

Firebase CLI をインストールして設定するドキュメントをご覧くださいFirebase CLI を使用すると、Google Cloud で Canvas ウェブアプリを Firebase Hosting にマッピングし、必要に応じて手動でデプロイする Cloud Functions for Firebase へのフルフィルメント。

gactions コマンドラインツールをインストールする

gactions コマンドラインインターフェース（CLI）ツールで、そのパッケージを解凍し、実行パスを設定します。

gactions をインストールして構成する手順は次のとおりです。

ご使用のオペレーティングシステムに適したパッケージをダウンロードします。

プラットフォーム	パッケージ	チェックサム
Windows	ダウンロード	SHA256
Linux	ダウンロード	SHA256
Mac OS	ダウンロード	SHA256

任意の場所にパッケージを展開し、そのバイナリを環境の PATH 変数を使用します。または、パッケージを PATH 変数にすでにあるロケーション（例: /usr/local/bin）。
Linux と Mac では、必要に応じて実行権限を有効にします。
```
chmod +x PATH_TO/gactions
```
次のコマンドを実行して CLI を認証します。このコマンド認証フローを開始します。ウェブブラウザが必要です。
```
gactions login
```
フローが完了すると、CLI が自動的に認証されます。

プロジェクトを作成して設定する

gactions コマンドラインツールを使用する前に、プロジェクトへのアクセス権を gactions に付与します。作成と設定を行うには、次の操作を行います。

Actions Console に移動します。
[新しいプロジェクト] をクリックし、プロジェクト名を入力して、[プロジェクトを作成] をクリックします。
カテゴリを選択し、[次へ] をクリックします。
[空のプロジェクト] を選択し、[Start Building] をクリックします。
次の手順で Google Cloud コンソールで Actions API を有効にします。 Google Chat を有効または無効にする API をご覧ください。これにより、gactions がプロジェクトを操作できます。

Hello World サンプルを取得する

Hello World のインタラクティブなサンプルで、簡単なアクションの作成 1 つのアクションで作成できます。

空のディレクトリを作成し、Interactive Canvas サンプルを表示されます。たとえば、次のコードは、例として使用されている interactive-canvas-sample/ ディレクトリ以下の点をこのドキュメント全体で扱います。
```
gactions init interactive-canvas --dest interactive-canvas-sample
cd interactive-canvas-sample
```
interactive-canvas-sample/sdk/settings/settings.yaml ファイルを開き、 projectId フィールドの値をプロジェクトの ID に変更します。

注: プロジェクトの ID を取得するには、まず [アクション] ウィンドウでプロジェクトを開きます。その他アイコンをクリックします。次に、[プロジェクト設定] を選択し、[プロジェクト ID] の文字列をコピーします。フィールド。

サンプルをデプロイしてテストする

サンプルを設定したら、Interactive Canvas ウェブアプリをデプロイして、追加することもできます。このプロセスにより、アクションのドラフトバージョンが作成されますプロジェクトを作成して Actions Simulator にデプロイし、プレビューとテストを行うことができます。

interactive-canvas-sample/ ディレクトリから、次のコマンドを実行します。 Interactive Canvas ウェブアプリ（public/ のコンテンツ）をデプロイできます。ディレクトリにあります）。
```
firebase deploy --project PROJECT_ID --only hosting
```
レンダリングされたウェブアプリは、ブラウザでの Firebase CLI: https://PROJECT_ID.web.app。
interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js ファイルを開き、 CANVAS_URL 変数の値をプロジェクトのウェブアプリの URL に変更します。
```
const CANVAS_URL = 'https://PROJECT_ID.web.app';
```
interactive-canvas-sample/sdk/ ディレクトリから次のコマンドを実行します。コマンドを実行して、アクションプロジェクトのローカルバージョンをドラフトバージョン:
```
gactions push
```
注: 一部のプロジェクト設定がないことを示す警告がいくつか表示されます。リソースを定義します。無視しても問題ありません。無視しても構いません。
interactive-canvas-sample/sdk/ ディレクトリから次のコマンドを実行します。コマンドを使用して、シミュレータで Actions プロジェクトをテストします。
```
gactions deploy preview
```
注: 新しいプロジェクトを使用する場合は、Cloud Functions の関数を有効にする必要があります。 API を実行し、請求先アカウントを Google Cloud のプロジェクトに関連付けます。 Cloud Functions API を有効にするには、 Cloud コンソール。
コマンドラインツールから返されたリンクを開いて、シミュレータに移動します。
シミュレータで、「Talk to Interactive canvas sample」と入力してアクションを開始します。マイページウェブアプリを使用して回転する三角形が https://PROJECT_ID.web.app
<ph type="x-smartling-placeholder">
</ph>
図 1.Actions プロジェクトをプレビューするシミュレータ