Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A ferramenta de interface de linha de comando (CLI) do gactions ajuda a criar a interface
a estrutura e os arquivos do projeto e os implanta como um projeto do Actions
no console do Google Cloud. Para acessar informações sobre como usar a ferramenta de linha de comando em cenários comuns
depois da instalação e configuração, consulte o guia do usuário
como alternativa.
Depois de instalada, você pode conferir um resumo da funcionalidade da ferramenta na
terminal:
gactions --help
A seguinte resposta é exibida:
Command Line Interface for Google Actions SDK
Usage:
gactions [command]
Available Commands:
decrypt Decrypt client secret.
deploy Deploy an Action to the specified channel.
encrypt Encrypt client secret.
help Help about any command
init Initialize a directory for a new project.
login Authenticate gactions CLI to your Google account via web browser.
logout Log gactions CLI out of your Google Account.
pull This command pulls files from Actions Console into the local file system.
push This command pushes changes in the local files to Actions Console.
third-party-notices Prints license files of third-party software used.
version Prints current version of the CLI.
Flags:
-h, --help help for gactions
-v, --verbose Display additional error information
Use "gactions [command] --help" for more information about a command.
Instalar a ferramenta de linha de comando do gactions
Instale a ferramenta de interface de linha de comando (CLI) do gactions fazendo o download de um
o pacote de instalação, descompactá-lo e configurar o caminho de execução.
Para instalar e configurar o gactions, siga estas etapas:
Faça o download do pacote adequado para seu sistema operacional:
Extraia o pacote no local que quiser e adicione o binário ao seu
variável PATH do ambiente. Como alternativa, extraia o pacote para um
local que já está na sua variável PATH (por exemplo, /usr/local/bin).
No Linux e no Mac, ative as permissões de execução, se necessário:
chmod +x PATH_TO/gactions
Execute o comando a seguir para autenticar a CLI. Esse comando
inicia um fluxo de autenticação e requer um navegador da Web:
gactions login
Quando o fluxo é concluído, a CLI é autenticada automaticamente.
Criar e configurar um projeto
Antes de poder usar a ferramenta de linha de comando gactions, você deve criar um projeto em
Console do Actions e concede aos gactions acesso ao projeto. Para criar e definir
um projeto, faça o seguinte:
Clique em Novo projeto, digite um nome e clique em Criar projeto.
Selecione uma categoria e clique em Próxima.
Selecione Projeto em branco e clique em Começar a criar.
Ative a API Actions no console do Google Cloud da seguinte forma:
as instruções em Ativar e desativar
APIs.
Isso permite que os gactions interajam com seu projeto.
Inicializar uma amostra
Crie um diretório vazio e execute gactions init SAMPLE_NAME
desse diretório para importar um exemplo de projeto do Actions. Você pode usar o exemplo
projeto como modelo para criar seu próprio projeto e entender um plano
estrutura do projeto.
Por exemplo, o comando a seguir resulta no conteúdo do hello-world
que está sendo adicionado ao seu diretório:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eThe \u003ccode\u003egactions\u003c/code\u003e command-line interface (CLI) helps you create, manage, and deploy Google Actions projects.\u003c/p\u003e\n"],["\u003cp\u003eYou can download and install \u003ccode\u003egactions\u003c/code\u003e for Windows, Linux, or Mac OS, then authenticate it with your Google account.\u003c/p\u003e\n"],["\u003cp\u003eBefore using \u003ccode\u003egactions\u003c/code\u003e, create a project in the Actions console and enable the Actions API.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003egactions init\u003c/code\u003e to initialize a new project based on a sample, providing a starting point for your development.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the user guide for detailed instructions and common usage scenarios after setting up the tool.\u003c/p\u003e\n"]]],[],null,["# gactions overview\n\nThe gactions command line interface (CLI) tool helps you create the required\nproject structure and files and deploy them as an Actions project in the Actions\nconsole. For information on using the command-line tool in common scenarios\nafter it's installed and set up, see the [user guide](/assistant/actionssdk/gactions/guide)\ninstead.\n\nOnce installed, you can get a summary of the tool's functionality in your\nterminal: \n\n```text\ngactions --help\n```\n\nThe following output appears: \n\n```\nCommand Line Interface for Google Actions SDK\n\nUsage:\n gactions [command]\n\nAvailable Commands:\n decrypt Decrypt client secret.\n deploy Deploy an Action to the specified channel.\n encrypt Encrypt client secret.\n help Help about any command\n init Initialize a directory for a new project.\n login Authenticate gactions CLI to your Google account via web browser.\n logout Log gactions CLI out of your Google Account.\n pull This command pulls files from Actions Console into the local file system.\n push This command pushes changes in the local files to Actions Console.\n third-party-notices Prints license files of third-party software used.\n version Prints current version of the CLI.\n\nFlags:\n -h, --help help for gactions\n -v, --verbose Display additional error information\n\nUse \"gactions [command] --help\" for more information about a command.\n```\n\nInstall the gactions command-line tool\n--------------------------------------\n\nInstall the gactions command line interface (CLI) tool by downloading an\ninstallation package, unpacking it, and configuring your execution path.\n\nTo install and configure gactions, follow these steps:\n\n1. Download the appropriate package for your operating system:\n\n | Platform | Package | Checksum |\n |----------|----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------|\n | Windows | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_windows.zip) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_windows.zip.sha256) |\n | Linux | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_linux.tar.gz) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_linux.tar.gz.sha256) |\n | Mac OS | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_darwin.tar.gz) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_darwin.tar.gz.sha256) |\n\n2. Extract the package to a location of your choice and add the binary to your\n environment's `PATH` variable. Alternatively, extract the package to a\n location that's already in your `PATH` variable (for example, `/usr/local/bin`).\n\n3. On Linux and Mac, enable execute permissions if necessary:\n\n ```scdoc\n chmod +x PATH_TO/gactions\n ```\n4. Run the following command to authenticate the CLI. This command\n starts an authentication flow and requires a web browser:\n\n ```text\n gactions login\n ```\n\n When the flow is complete, the CLI automatically authenticates.\n\nCreate and set up a project\n---------------------------\n\n| **Note:** Actions project creation is not supported in the gactions CLI.\n\nBefore you can use the gactions command-line tool, you must create a project in\nthe Actions console and give gactions access to the project. To create and set\nup a project, do the following:\n\n1. Go to the [Actions console](https://console.actions.google.com).\n2. Click **New project** , enter a project name, and click **Create project**.\n3. Select a category and click **Next**.\n4. Select **Blank project** and click **Start building**.\n5. Enable the **Actions API** in the Google Cloud console by following the instructions in [Enable and disable\n APIs](https://support.google.com/googleapi/answer/6158841). This allows gactions to interact with your project.\n\nInitialize a sample\n-------------------\n\nCreate an empty directory, then run `gactions init `\u003cvar translate=\"no\"\u003eSAMPLE_NAME\u003c/var\u003e\nfrom that directory to import a sample Actions project. You can use the sample\nproject as a model to create your own project and to understand an Actions\nproject's structure.\n\nFor instance, the following command results in the contents of the `hello-world`\nsample being added to your directory: \n\n```text\ngactions init hello-world\n```"]]
