actions-on-google / actions-builder-conversation-components-nodejs

Conversation Components sample (using Actions Builder) in Node.js

Actions on Google: Conversation Components Sample

⚠️ Warning: Conversational Actions will be deprecated on June 13, 2023. For more information, see Conversational Actions Sunset.

Prerequisites

1. Node.js and NPM
   • We recommend installing using nvm for Linux/Mac and nvm-windows for Windows
2. Install the Firebase CLI
   • We recommend using MAJOR version 8 , npm install -g firebase-tools@^8.0.0
   • Run firebase login with your Google account

Setup

Actions Console

1. From the Actions on Google Console, New project > Create project > under What kind of Action do you want to build? > Custom > Blank project

Actions CLI

1. Install the Actions CLI
2. Navigate to sdk/settings/settings.yaml, and replace <PROJECT_ID> with your project ID
3. Run gactions login to login to your account.
4. Run gactions push to push your project.
5. Run gactions deploy preview to deploy your project.

Running this Sample

• You can test your Action on any Google Assistant-enabled device on which the Assistant is signed into the same account used to create this project. Just say or type, “OK Google, talk to my test app”.
• You can also use the Actions on Google Console simulator to test most features and preview on-device behavior.

Running tests

This Action uses the Assistant conversation testing library for testing. Follow the steps below to run the tests for this project:

1. Enable the Actions API for your project (The Actions API is enabled by default for newly created projects):
   1. Visit the Google API console and select your project from the Select a project dropdown.
   2. If the Action API is not enabled, search for "Actions API" and click Enable.
2. Create a Service Account key:
   1. Visit the Google Cloud console credentials page and select your project from the Select a project dropdown.
   2. In the "Service Accounts" click on the "App Engine default service account" service account.
   3. Enter a service account name and click Create.
   4. From the Select a role dropdown, select Project > Owner.
   5. Click Continue.
   6. Click ADD KEY, then select Create new key, then press CREATE to download the service account JSON file.
3. Rename the service account file to service_account.json, and place it in the root folder of the project.
4. Enable Web and App Activity Controls for the service account. It is necessary to have this setting enabled in order to call the Actions API.
   • npm run enable-activity-controls
5. Run tests
   • npm run test

References & Issues

• Questions? Go to StackOverflow or the Assistant Developer Community on Reddit.
• For bugs, please report an issue on Github.
• Actions on Google Documentation
• Actions on Google Codelabs

Contributing

Please read and follow the steps in the CONTRIBUTING.md.

License

See LICENSE.