Join the Actions on Google Developer Challenge to win a trip to Google I/O 2018 and more than 20 other prizes.

gactions CLI

gactions is the command line interface that you use to test and update your app for the Assistant.

Downloads

You can download gactions for your operating system (below):

OS Downloads
Windows
Mac
Linux

Supported arguments

The following table describes the supported arguments for gactions:

Argument Description
help Prints the help text for this tool. For example:

$ gactions help

To print the help text for a specific argument, use the following syntax:

$ gactions help argument

For example:

$ gactions help deploy
init Creates a default action.json file in the current directory with the following syntax:

$ gactions init

If there is already an existing action.json file, you can overwrite it by adding the --force argument, as the following example shows:

$ gactions init --force
list Lists up to 10 recent versions of your app for the Assistant: in review, production, approved, etc, with the following syntax:

$ gactions list --project PROJECT_ID
test Pushes an action package to the Assistant Platform for testing with the following syntax:

$ gactions test --action_package PACKAGE_NAME --project PROJECT_ID

For example:

$ gactions test --action_package mypackage.json --project my-project-1234567

By default, you can test indefinitely. You can optionally specify the number of minutes before the action package should expire with the
--preview_mins flag, as the following example shows:

$ gactions test --action_package mypackage.json --preview_mins 420

You can optionally disable testing in the sandbox environment with the
--disable_sandbox flag.

update Updates the draft action in the Assistant app for the given project with the following syntax:

$ gactions update --action_package PACKAGE_NAME --project PROJECT_ID

For example:

$ gactions update --action_package action.json --project my-project-1234567

To use the update argument, you must have an Actions on Google Cloud Project ID. You can get your project ID by clicking on the settings gear settings in your Actions on Google project and then clicking on Project Settings.

selfupdate gactions automatically checks for updates before each command runs, but you can force that check with selfupdate

$ gactions selfupdate
Argument Description
preview Pushes an action package to the Assistant Platform for testing with the following syntax:

$ gactions preview --action_package PACKAGE_NAME

For example:

$ gactions preview --action_package mypackage.json

You can optionally specify the number of minutes before the action package should expire with the
--preview_mins flag, as the following example shows:

$ gactions preview --action_package mypackage.json --preview_mins 420

You can optionally specify the invocation name with the
--invocation_name flag. The default name is "My Action". For example:

$ gactions preview --action_package mypackage.json --invocation_name "rhyme finder"
deploy Submits the action package for review and publication with the following syntax:

$ gactions deploy --action_package PACKAGE_NAME --project PROJECT_ID

For example:

$ gactions deploy --action_package action.json --project my-project-1234567

To use the deploy argument, you must have a Google Cloud Project ID. For more information, see Deploying a Conversation Action.

Printing verbose output

To print more detailed output during processing, add the --verbose flag. For example:

$ gactions --verbose test --action_package action.json --project my-project-1234567