panoramica delle interazioni

Lo strumento dell'interfaccia a riga di comando (CLI) di gactions consente di creare la struttura e i file di progetto richiesti e di eseguirne il deployment come progetto Actions nella console Actions. Per informazioni sull'utilizzo dello strumento a riga di comando in scenari comuni dopo l'installazione e la configurazione, consulta la guida dell'utente.

Dopo l'installazione, puoi ottenere un riepilogo delle funzionalità dello strumento nel terminale:

gactions --help

Viene visualizzato il seguente output:

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.

Installare lo strumento a riga di comando gactions

Installa lo strumento di interfaccia a riga di comando (CLI) gactions scaricando un pacchetto di installazione, decomprimendolo e configurando il percorso di esecuzione.

Per installare e configurare le azioni, procedi nel seguente modo:

  1. Scarica il pacchetto appropriato per il tuo sistema operativo:

    Piattaforma Package Checksum
    Windows Scarica SHA256
    Linux Scarica SHA256
    Sistema operativo Mac Scarica SHA256

  2. Estrai il pacchetto nella posizione che preferisci e aggiungi il programma binario alla variabile PATH del tuo ambiente. In alternativa, estrai il pacchetto in una posizione già presente nella variabile PATH (ad esempio, /usr/local/bin).

  3. Su Linux e Mac, abilita le autorizzazioni di esecuzione se necessario:

    chmod +x PATH_TO/gactions

  4. Esegui questo comando per autenticare l'interfaccia a riga di comando. Questo comando avvia un flusso di autenticazione e richiede un browser web:

    gactions login

    Al termine del flusso, l'interfaccia a riga di comando esegue automaticamente l'autenticazione.

Creare e configurare un progetto

Prima di poter utilizzare lo strumento a riga di comando gactions, devi creare un progetto nella console di Actions e concedere l'accesso alle azioni al progetto. Per creare e configurare un progetto, segui questi passaggi:

  1. Vai alla Console di Actions.
  2. Fai clic su Nuovo progetto, inserisci un nome per il progetto e fai clic su Crea progetto.
  3. Seleziona una categoria e fai clic su Avanti.
  4. Seleziona Progetto vuoto e fai clic su Inizia a creare.
  5. Abilita l'API Actions nella console Google Cloud seguendo le istruzioni riportate in Abilitare e disabilitare le API. In questo modo le gactions possono interagire con il tuo progetto.

Inizializzare un campione

Crea una directory vuota, quindi esegui gactions init SAMPLE_NAME da quella directory per importare un progetto Actions di esempio. Puoi utilizzare il progetto di esempio come modello per creare il tuo progetto e comprendere la struttura di un progetto Actions.

Ad esempio, il seguente comando comporta l'aggiunta dei contenuti dell'esempio hello-world alla directory:

gactions init hello-world