Übersicht über die Aktionen

Mit der gactions-Befehlszeile können Sie die erforderliche Projektstruktur und die erforderlichen Dateien erstellen und als Actions-Projekt in der Actions Console bereitstellen. Informationen zur Verwendung des Befehlszeilentools nach der Installation und Einrichtung in gängigen Szenarien finden Sie im Nutzerhandbuch.

Nach der Installation können Sie eine Zusammenfassung der Funktionen des Tools in Ihrem Terminal erhalten:

gactions --help

Die Ausgabe sieht so aus:

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.

gactions-Befehlszeilentool installieren

Installieren Sie das Befehlszeilen-Tool gactions. Laden Sie dazu ein Installationspaket herunter, entpacken Sie es und konfigurieren Sie den Ausführungspfad.

So installieren und konfigurieren Sie Sitelinks:

  1. Laden Sie das entsprechende Paket für Ihr Betriebssystem herunter:

    Plattform Paket Prüfsumme
    Windows Herunterladen SHA256
    Linux Herunterladen SHA256
    macOS Herunterladen SHA256
  2. Extrahieren Sie das Paket an einen Speicherort Ihrer Wahl und fügen Sie die Binärdatei in die PATH-Variable Ihrer Umgebung ein. Alternativ können Sie das Paket an einen Speicherort extrahieren, der sich bereits in der PATH-Variable befindet (z. B. /usr/local/bin).

  3. Aktivieren Sie unter Linux und Mac bei Bedarf die Ausführungsberechtigungen:

    chmod +x PATH_TO/gactions
  4. Führen Sie den folgenden Befehl aus, um die Befehlszeile zu authentifizieren. Dieser Befehl startet einen Authentifizierungsvorgang und erfordert einen Webbrowser:

    gactions login

    Wenn der Vorgang abgeschlossen ist, wird die Befehlszeile automatisch authentifiziert.

Projekt erstellen und einrichten

Bevor Sie das gactions-Befehlszeilentool verwenden können, müssen Sie ein Projekt in der Actions Console erstellen und gactions Zugriff darauf gewähren. So erstellen und richten Sie ein Projekt ein:

  1. Rufen Sie die Actions Console auf.
  2. Klicken Sie auf Neues Projekt, geben Sie einen Projektnamen ein und klicken Sie auf Projekt erstellen.
  3. Wählen Sie eine Kategorie aus und klicken Sie auf Weiter.
  4. Wählen Sie Leeres Projekt aus und klicken Sie auf Mit der Erstellung beginnen.
  5. Aktivieren Sie die Actions API in der Google Cloud Console. Folgen Sie dazu der Anleitung unter APIs aktivieren und deaktivieren. Dies ermöglicht es gactions, mit deinem Projekt zu interagieren.

Sample initialisieren

Erstellen Sie ein leeres Verzeichnis und führen Sie in diesem Verzeichnis gactions init SAMPLE_NAME aus, um ein Beispiel-Actions-Projekt zu importieren. Sie können das Beispielprojekt als Modell verwenden, um Ihr eigenes Projekt zu erstellen und die Struktur eines Actions-Projekts zu verstehen.

Mit dem folgenden Befehl wird beispielsweise der Inhalt des Beispiels hello-world in Ihr Verzeichnis aufgenommen:

gactions init hello-world