przegląd interakcji

Narzędzie interfejsu wiersza poleceń (CLI) interfejsu API pomaga utworzyć wymaganą strukturę projektu i pliki oraz wdrożyć je jako projekt Actions w konsoli Actions. Informacje o korzystaniu z narzędzia wiersza poleceń w typowych scenariuszach po jego zainstalowaniu i skonfigurowaniu znajdziesz w przewodniku użytkownika.

Po zainstalowaniu narzędzia możesz zobaczyć w terminalu podsumowanie jego funkcji:

gactions --help

Pojawią się te dane wyjściowe:

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.

Zainstaluj narzędzie wiersza poleceń gactions

Zainstaluj narzędzie wiersza poleceń (CLI) interfejsu gactions, pobierając pakiet instalacyjny, rozpakowując go i konfigurując ścieżkę wykonania.

Aby zainstalować i skonfigurować interakcje, wykonaj te czynności:

  1. Pobierz pakiet odpowiedni dla używanego systemu operacyjnego:

    Platforma Pakiet Suma kontrolna
    Windows Pobierz SHA256
    Linux Pobierz SHA256
    System operacyjny macOS Pobierz SHA256
  2. Wyodrębnij pakiet do wybranej lokalizacji i dodaj plik binarny do zmiennej PATH środowiska. Możesz też wyodrębnić pakiet do lokalizacji, która jest już w zmiennej PATH (np. /usr/local/bin).

  3. W systemie Linux i na Macu włącz w razie potrzeby uprawnienia do wykonywania:

    chmod +x PATH_TO/gactions
  4. Uruchom to polecenie, aby uwierzytelnić interfejs wiersza poleceń. To polecenie uruchamia proces uwierzytelniania i wymaga przeglądarki:

    gactions login

    Po zakończeniu procesu interfejs wiersza poleceń automatycznie się uwierzytelni.

Tworzenie i konfigurowanie projektu

Aby korzystać z narzędzia wiersza poleceń gactions, musisz utworzyć projekt w konsoli Actions i przyznać gacjom dostęp do projektu. Aby utworzyć i skonfigurować projekt:

  1. Otwórz Konsolę Actions.
  2. Kliknij Nowy projekt, wpisz nazwę projektu i kliknij Utwórz projekt.
  3. Wybierz kategorię i kliknij Dalej.
  4. Wybierz Pusty projekt i kliknij Rozpocznij tworzenie.
  5. Włącz Actions API w konsoli Google Cloud zgodnie z instrukcjami podanymi w artykule Włączanie i wyłączanie interfejsów API. Dzięki temu mogą wchodzić w interakcje z Twoim projektem.

Inicjowanie próbki

Utwórz pusty katalog, a następnie uruchom z niego polecenie gactions init SAMPLE_NAME, aby zaimportować przykładowy projekt Actions. Możesz użyć przykładowego projektu jako modelu, aby utworzyć własny projekt i poznać strukturę projektu w Actions.

Na przykład to polecenie spowoduje dodanie do katalogu zawartości przykładowego pliku hello-world:

gactions init hello-world