Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La herramienta de la interfaz de línea de comandos (CLI) de gactions te ayuda a crear
los archivos y la estructura del proyecto y, luego, implementarlos como un proyecto de Actions
de Cloud. Para obtener información sobre el uso de la herramienta de línea de comandos en situaciones comunes
después de la instalación y configuración, consulta la guía del usuario
en su lugar.
Una vez instalada, podrás obtener un resumen de la funcionalidad de la herramienta en tu
terminal:
gactions --help
Aparece este resultado:
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.
Instala la herramienta de línea de comandos gactions
Instala la herramienta de la interfaz de línea de comandos (CLI) de gactions. Para ello, descarga un
del paquete de instalación, desempaquetarlo y configurar la ruta de ejecución.
Para instalar y configurar gactions, sigue estos pasos:
Descarga el paquete adecuado para tu sistema operativo:
Extrae el paquete en la ubicación que desees y agrega el objeto binario a tu
variable PATH del entorno. Como alternativa, extrae el paquete en un
ubicación que ya está en tu variable PATH (por ejemplo, /usr/local/bin).
En Linux y Mac, habilita los permisos de ejecución si es necesario:
chmod +x PATH_TO/gactions
Ejecuta el siguiente comando para autenticar la CLI. Este comando
inicia un flujo de autenticación y requiere un navegador web:
gactions login
Cuando se completa el flujo, la CLI se autentica automáticamente.
Crea y configura un proyecto
Antes de poder usar la herramienta de línea de comandos gactions, debes crear un proyecto en
la Consola de Actions y otorgar acceso a gactions al proyecto. Para crear y configurar
un proyecto, haz lo siguiente:
Haz clic en Proyecto nuevo, ingresa un nombre para el proyecto y haz clic en Crear proyecto.
Selecciona una categoría y haz clic en Siguiente.
Selecciona Proyecto en blanco y haz clic en Comenzar compilación.
Habilita la API de Actions en la consola de Google Cloud de la siguiente manera:
las instrucciones en Cómo habilitar e inhabilitar
APIs.
Esto permite que gactions interactúen con tu proyecto.
Inicializa una muestra
Crea un directorio vacío y, luego, ejecuta gactions init SAMPLE_NAME.
de ese directorio para importar un proyecto de Actions de muestra. Puedes usar la herramienta de muestra
proyecto como modelo para crear tu propio proyecto y comprender una acción
la estructura del proyecto.
Por ejemplo, el siguiente comando da como resultado el contenido de hello-world
ejemplo que se agregará a tu directorio:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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```"]]
