/actions-builder-account-linking-nodejs

Account Linking sample (using Actions Builder) in Node.js

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Actions on Google: Account Linking with Google Sign-In Sample

This sample demonstrates Actions on Google features for use on Google Assistant including account linking and Google Sign In -- using the Node.js client library, Firebase Authentication, and deployed on Cloud Functions for Firebase.

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

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? > Custom > Blank project

Account Linking Configuration

  1. Return to the Actions on Google Console.
  2. From the top navigation menu under Develop > Account linking (left nav), under Google Sign In Client Information, copy the value of Client ID issued by Google to your Actions.
  3. Return to your local copy of the sample.
  4. Open the .env file in the sdk/webhooks/ActionsOnGoogleFulfillment/ directory, and replace ${CLIENT_ID} with the value you got from the Console in the previous step.

Firebase Google Sign-In Integration

  1. From the Firebase console, find and select your Actions on Google Project ID
  2. In the left navigation menu under Develop section > Authentication > Sign-in method > Select Google > Toggle Enable > Click Save

Firestore Database

  1. From the Firebase console, find and select your Actions on Google Project ID
  2. In the left navigation menu under Develop section > Database > Create database button > Select Start in test mode > Done

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.

References & Issues

Contributing

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

License

See LICENSE.