Présentation de gactions

L'outil d'interface de ligne de commande (CLI) gactions vous permet de créer la structure et les fichiers de projet requis et de les déployer en tant que projet Actions dans la console Actions. Pour en savoir plus sur l'utilisation de l'outil de ligne de commande dans les scénarios courants après l'installation et la configuration, consultez le guide de l'utilisateur.

Une fois l'outil installé, un résumé des fonctionnalités de l'outil s'affiche:

gactions --help

Le résultat suivant s'affiche :

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.

Installer l'outil de ligne de commande gactions

Installez l'outil de ligne de commande (CLI) gactions en téléchargeant un package d'installation, en le décompressant et en configurant votre chemin d'exécution.

Pour installer et configurer des gactions, procédez comme suit:

1. Téléchargez le package correspondant à votre système d'exploitation:

   Plate-forme	Empaqueter	Total
   Windows	Télécharger	SHA256
   Linux	Télécharger	SHA256
   macOS	Télécharger	SHA256

2. Extrayez le package à l'emplacement de votre choix et ajoutez le binaire à la variable PATH de votre environnement. Vous pouvez également extraire le package à un emplacement déjà présent dans votre variable PATH (par exemple, /usr/local/bin).

3. Sous Linux et Mac, activez les autorisations d'exécution si nécessaire:

   chmod +x PATH_TO/gactions

4. Exécutez la commande suivante pour authentifier la CLI. Cette commande lance un flux d'authentification et nécessite un navigateur Web:

   gactions login

   Une fois le flux terminé, la CLI s'authentifie automatiquement.

Créer et configurer un projet

Avant de pouvoir utiliser l'outil de ligne de commande gactions, vous devez créer un projet dans la console Actions et autoriser l'accès gactions à ce projet. Pour créer et configurer un projet, procédez comme suit:

1. Accédez à la console Actions.
2. Cliquez sur Nouveau projet, saisissez un nom de projet, puis cliquez sur Créer un projet.
3. Sélectionnez une catégorie, puis cliquez sur Next (Suivant).
4. Sélectionnez Projet vide, puis cliquez sur Démarrer la compilation.
5. Activez l'API Actions dans la console Google Cloud en suivant les instructions de la section Activer et désactiver des API. Cela permet aux gactions d'interagir avec votre projet.

Initialiser un exemple

Créez un répertoire vide, puis exécutez gactions init SAMPLE_NAME à partir de ce répertoire pour importer un exemple de projet Actions. Vous pouvez utiliser l'exemple de projet comme modèle pour créer votre propre projet et comprendre la structure d'un projet Actions.

Par exemple, la commande suivante entraîne l'ajout du contenu de l'exemple hello-world à votre répertoire:

gactions init hello-world