L'outil d'interface de ligne de commande (CLI) gactions vous aide à créer la structure et les fichiers de projet requis, puis à 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 son installation et sa configuration, consultez plutôt le guide de l'utilisateur.
Une fois l'outil installé, vous pouvez obtenir un résumé de ses fonctionnalités dans votre terminal:
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 d'interface 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 les gactions, procédez comme suit:
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 Extrayez le package à l'emplacement de votre choix, puis ajoutez le binaire à la variable
PATH
de votre environnement. Vous pouvez également extraire le package vers un emplacement qui se trouve déjà dans votre variablePATH
(par exemple,/usr/local/bin
).Sous Linux et Mac, activez les autorisations d'exécution si nécessaire:
chmod +x PATH_TO/gactions
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 gactions à y accéder. Pour créer et configurer un projet, procédez comme suit:
- Accédez à la console Actions.
- Cliquez sur Nouveau projet, saisissez un nom de projet, puis cliquez sur Créer un projet.
- Sélectionnez une catégorie, puis cliquez sur Suivant.
- Sélectionnez Blank project (Projet vide), puis cliquez sur Start build (Commencer à créer).
- 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