descripción general de gactions

La herramienta de la interfaz de línea de comandos (CLI) de gactions te ayuda a crear la estructura del proyecto y los archivos necesarios y, luego, 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 la instalación y configuración, consulta la guía del usuario.

Una vez instalada, podrás obtener un resumen de su funcionalidad 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.

Cómo instalar la herramienta de línea de comandos de 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 gactions, 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 en la ubicación que desees 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 automáticamente.

Crea y configura un proyecto

Para poder usar la herramienta de línea de comandos de gactions, debes crear un proyecto en la Consola de Actions y otorgarle a gactions acceso 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 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 la consola de Google Cloud, sigue las instrucciones que se indican en Inhabilita y habilita las APIs. Esto permite que las gactions interactúen con tu proyecto.

Inicializa una muestra

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

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

gactions init hello-world