descripción general de gactions

La herramienta de la interfaz de línea de comandos (CLI) de gactions te ayuda a crear los archivos y la estructura del proyecto necesarios, y a implementarlos como un proyecto de Acciones en la Consola de Actions. Para obtener información sobre el uso de la herramienta de línea de comandos en situaciones comunes después de que se instala y configura, consulta la guía del usuario.

Una vez instalado, puedes 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

Para instalar la herramienta de la interfaz de línea de comandos (CLI) de gactions, descarga un paquete de instalación, descomprímelo y configura la ruta de ejecución.

Para instalar y configurar gacciones, sigue estos pasos:

1. Descarga el paquete adecuado para tu sistema operativo:

   Plataforma	Paquete	Suma de comprobación
   Windows	Descargar	SHA256
   Linux	Descargar	SHA256
   macOS	Descargar	SHA256

2. Extrae el paquete a una ubicación de tu elección y agrega el objeto binario a la variable PATH de tu entorno. Como alternativa, extrae el paquete en una ubicación que ya esté en tu variable PATH (por ejemplo, /usr/local/bin).

3. En Linux y Mac, habilita los permisos de ejecución si es necesario:

   chmod +x PATH_TO/gactions

4. 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 de forma automática.

Cómo crear y configurar un proyecto

Nota: La CLI de gactions no admite la creación de proyectos de acciones.

Para poder usar la herramienta de línea de comandos de gactions, debes crear un proyecto en la Consola de Actions y otorgar acceso de gactions al proyecto. Para crear y configurar un proyecto, haz lo siguiente:

1. Ve a la Consola de Actions.
2. Haz clic en Proyecto nuevo, ingresa un nombre para el proyecto y haz clic en Crear proyecto.
3. Selecciona una categoría y haz clic en Siguiente.
4. Selecciona Blank project y haz clic en Start Building.
5. Para habilitar la API de Actions en Google Cloud Console, sigue las instrucciones que se indican en Habilita o inhabilita API. Esto permite que las gacciones interactúen con tu proyecto.

Inicializa una muestra

Crea un directorio vacío y ejecuta gactions init SAMPLE_NAME desde ese directorio para importar un proyecto de acciones de muestra. Puedes usar el proyecto de muestra como modelo para crear tu propio proyecto y comprender la estructura de este.

Por ejemplo, el siguiente comando hace que el contenido de la muestra de hello-world se agregue a tu directorio:

gactions init hello-world