All Projects → manekinekko → Google Actions Starter

manekinekko / Google Actions Starter

A Node.js server for Google Assistant (and Google Home).

Programming Languages

javascript
184084 projects - #8 most used programming language

Projects that are alternatives of or similar to Google Actions Starter

Bitcoin Info Action
App for the google assistant that give you information on bitcoin (e.g. price, market cap etc')
Stars: ✭ 45 (-47.06%)
Mutual labels:  assistant, google-cloud, google
Psgsuite
Powershell module for Google / G Suite API calls wrapped in handy functions. Authentication is established using a service account via P12 key to negate the consent popup and allow for greater handsoff automation capabilities
Stars: ✭ 184 (+116.47%)
Mutual labels:  google-cloud, google
Marmot
Marmot workflow execution engine
Stars: ✭ 174 (+104.71%)
Mutual labels:  google-cloud, google
Macassistant
Google Assistant for macOS!
Stars: ✭ 1,564 (+1740%)
Mutual labels:  assistant, google
Esp V2
A service proxy that provides API management capabilities using Google Service Infrastructure.
Stars: ✭ 120 (+41.18%)
Mutual labels:  google-cloud, google
Gam
command line management for Google Workspace
Stars: ✭ 2,558 (+2909.41%)
Mutual labels:  google-cloud, google
Google Cloud Cpp
C++ Client Libraries for Google Cloud Services
Stars: ✭ 233 (+174.12%)
Mutual labels:  google-cloud, google
Firegraph
GraphQL Superpowers for Google Cloud Firestore
Stars: ✭ 80 (-5.88%)
Mutual labels:  google-cloud, google
Gassistpi
Google Assistant for Single Board Computers
Stars: ✭ 911 (+971.76%)
Mutual labels:  assistant, google
Cloud Functions Go
Unofficial Native Go Runtime for Google Cloud Functions
Stars: ✭ 427 (+402.35%)
Mutual labels:  google-cloud, google
Assistants Pi
Headless Google Assistant and Alexa on Raspberry Pi
Stars: ✭ 280 (+229.41%)
Mutual labels:  assistant, google
Google Assistant Java Demo
A simple Google Assistant Client in Java
Stars: ✭ 53 (-37.65%)
Mutual labels:  assistant, google
Google Auth Library Nodejs
🔑 Google Auth Library for Node.js
Stars: ✭ 1,094 (+1187.06%)
Mutual labels:  google-cloud, google
Vue Mdc
Material web components for Vue.js
Stars: ✭ 1,217 (+1331.76%)
Mutual labels:  google
Is Google
Verify that a request is from Google crawlers using Google's DNS verification steps
Stars: ✭ 82 (-3.53%)
Mutual labels:  google
Gsoc Accepted Proposals
GSoC Accepted Proposals for the year 2015 to 2020
Stars: ✭ 79 (-7.06%)
Mutual labels:  google
Userscripts
Userscripts for Greasemonkey, Tampermonkey etc.
Stars: ✭ 78 (-8.24%)
Mutual labels:  google
Node Google Dfp
A service for integrating with Google DFP over NodeJS
Stars: ✭ 84 (-1.18%)
Mutual labels:  google
Google It Automation
google it automation with python professional certificate
Stars: ✭ 81 (-4.71%)
Mutual labels:  google
Tensorflowexample
Tensorflow实例
Stars: ✭ 78 (-8.24%)
Mutual labels:  google

GAS-S: Google Assistant Server Starter

A Node.js server for your Google Assistant (and Google Home).

Action Manifest (action.json)

{
    "versionLabel": "1.0.0",
    "agentInfo": {
        "languageCode": "en-US",
        "projectId": "my-first-action",
        "voiceName": "female_2"
    },
    "actions": [{
        "initialTrigger": {
            "intent": "assistant.intent.action.MAIN"
        },
        "httpExecution": {
            "url": "<PUBLIC URL>"
        }
    }]
}

NOTE: if you're deploying your action on Google Cloud, use your Google Cloud Project ID instead of "my-first-action".

Package.json

In the package.json, we provide you with the following (handy) scripts:

{
    "scripts": {
        "start": "npm run server",
        "server": "nodemon dist/action.js",
        "ngrok": "ngrok http 8080",
        "build": "babel lib -d dist",
        "build:watch": "npm run build -- -w",
        "action:simulate": "gactions --verbose simulate",
        "action:preview": "node ./scripts/preview_action.js",
        "action:config": "node ./scripts/update_action_config.js",
        "action:autopreview": "npm run action:config && npm run action:preview",
        "action:deploy": "gactions deploy --action_package action.json --project my-first-action",
        "release": "npm run build && npm version patch && git push --tags && git push && npm publish"
    }
}

NOTE: The default port used by GAS is 8080. See API section.

Tools bunlded by GAS for devs needs:

  1. gactions: is the command line interface that you use to preview, simulate, and publish an action package. If you encouter errors with the bundled binary, use the gactions from the official website. GAS includes this just for convenience.
  2. nodemon: Monitor for any changes in your node.js application and automatically restart the server.
  3. ngrok: Introspected tunnels to localhost. Allows Google's server to access your local action (while in dev mode)

Step by Step

  1. run npm install to install all deps
  2. run npm start
  3. run npm run ngrok and keep it running in the background,
  4. run npm run action:autopreview, and follow the instructions on the terminal,
  5. run npm run action:simulate to start the simulator in CLI mode (or use Google Home)
  6. type in talk to my first action or start my first action

HINT #1: you can run npm run build:watch in order to watch and rebuild your files on the fly while you're working on your action.

HINT #2: I you have a Google Home device, you can use it instead of using the simulator.

NOTE: If you already have a dev server where you can host your this project, you can use your own URL in httpExecution.url and skip steps 1 and 2. And run npm run action:preview instead. See package.json for more details.

GAS API

See the GAS documentation from more details.

Deep Link invocation

In order to make a deep link invocation, you have to provide two things:

  1. an invocation query in your action.json (see this example)
  2. an intent (and its implementation here and here) that will be triggered when your action will be launched with the invocation query.

Then you just have to start your action like so:

talk to my first action to <ONE OF THE DEEP LINK QUERIES HERE>

For instance:

talk to my first action to know what is the date

Deployment

Deploy the Fulfillment Endpoint

After you have created a Conversation Action you must first deploy your fulfillment endpoint to any provider, such as Google Cloud:

  1. Create a new project in Google Cloud Platform Projects and enable billing.
  2. Set current project with gcloud config set project my-first-action.
  3. Replace my-first-project with your project ID in vm.yaml and run gcloud deployment-manager deployments create production --config vm.yaml. You can check your deployment with gcloud deployment-manager deployments describe production.
  4. Deploy your code with npm run build && gcloud app deploy.

Create an Actions API Project

  1. Create a new Google Actions API project.
  2. Configure the project in "Directory listing". It's important to get the sample invocations right, eg. "Ok Google, ask my first action to ...".

Deploy Action

Deploying the action makes it usable by others by submitting it for approval with Google.

NOTE: Once submitted you have to wait for your action to be rejected or approved, there's no way to un-submit an action without contacting support.

  1. Change the httpExecution URL(s) in action.json to the deployed fulfillment URL, eg. https://my-first-action.appspot-preview.com.
  2. Replace my-first-action by your action's ID in package.json.
  3. Run npm run action:deploy, which will register and deploy your action.

See the GAS documentation for more details.

Example projects

License

The MIT License (MIT) Copyright (c) 2017 - Wassim CHEGHAM

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].