/actions-builder-canvas-nodejs

Interactive Canvas sample (using Actions Builder) in Node.js

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Actions on Google: Interactive Canvas Sample

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

This sample demonstrates Interactive Canvas for Google Assistant Actions.

Prerequisites

  1. Node.js and NPM
  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? > Game > Blank project for smart display

Firebase Hosting Deployment

  1. Run firebase deploy --project {PROJECT_ID} --only hosting to deploy the web app to Firebase Hosting
    • To find your Project ID: In the Actions Console console for your project, navigate to ⋮ > Project settings > Project ID.

Fulfillment setup

  1. Navigate to sdk/webhooks/ActionsOnGoogleFulfillment/index.js, and replace the place holder string https://PROJECT_ID.web.app of the CANVAS_URL variable with the URL to your own web app.

Actions CLI

  1. Install the Actions CLI
  2. Navigate to sdk/settings/settings.yaml, and replace <PROJECT_ID> with your project ID
  3. Navigate to the sdk/ directory by running cd sdk from the root directory of this project.
  4. Run gactions login to login to your account.
  5. Run gactions push to push your project.
  6. 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.

References & Issues

Contributing

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

License

See LICENSE.