Wprowadzanie tekstu

Widżet TextInput udostępnia pole, w którym użytkownicy mogą wpisywać tekst. Widżet obsługuje sugestie, które pomagają użytkownikom wprowadzać jednolite dane, oraz działania związane ze zmianą, czyli Actions wykonywane, gdy zmiana nastąpi w polu wprowadzania tekstu, np. użytkownik dodaje lub usuwa tekst.

Jeśli chcesz zbierać abstrakcyjne lub nieznane dane od użytkowników, używaj tego widżetu TextInput. Aby zbierać zdefiniowane dane o użytkownikach, użyj widżetu SelectionInput.

Informacje o przetwarzaniu tekstu wpisywanego przez użytkowników znajdziesz w sekcji Odbieranie danych z formularzy.

Oto karta składająca się z widżetu TextInput:

Reprezentacja i pola w formacie JSON

Zapis JSON
{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  },
  "placeholderText": string
}
Pola
name

string

Nazwa, po której dane wejściowe są identyfikowane w zdarzeniu danych wejściowych formularza.

Szczegółowe informacje o pracy z danymi wejściowymi do formularzy znajdziesz w artykule Odbieranie danych z formularzy.

label

string

Tekst wyświetlany nad polem do wprowadzania tekstu w interfejsie.

Wpisz tekst, który pomoże użytkownikowi wpisać informacje, których potrzebuje aplikacja. Jeśli np. pytasz kogoś o imię, a konkretnie nazwisko tej osoby, zamiast „name” wpisz surname.

Wymagane, jeśli właściwość hintText nie jest określona. W przeciwnym razie opcjonalne.

hintText

string

Tekst wyświetlany pod polem do wprowadzania tekstu, by pomóc użytkownikom, zachęcając ich do podania określonej wartości. Ten tekst jest zawsze widoczny.

Wymagane, jeśli właściwość label nie jest określona. W przeciwnym razie opcjonalne.

value

string

Wartość wpisana przez użytkownika zwrócona w ramach zdarzenia wprowadzania danych w formularzu.

Szczegółowe informacje o pracy z danymi wejściowymi do formularzy znajdziesz w artykule Odbieranie danych z formularzy.

type

enum (Type)

Sposób wyświetlania pola do wprowadzania tekstu w interfejsie. Na przykład czy pole jest jednowierszowe czy wielowierszowe.

onChangeAction

object (Action)

Co zrobić, gdy zmiana nastąpi w polu wprowadzania tekstu. Na przykład dodanie użytkownika do pola lub usunięcie tekstu.

Przykładowe działania, które należy wykonać, to uruchomienie funkcji niestandardowej lub otwarcie okna w Google Chat.

initialSuggestions

object (Suggestions)

Sugerowane wartości, które użytkownicy mogą wpisywać. Te wartości pojawiają się, gdy użytkownik kliknie w polu wprowadzania tekstu. Gdy użytkownicy wpisują treść, sugerowane wartości są dynamicznie filtrowane na podstawie wpisywanych przez nich informacji.

Na przykład w polu do wprowadzania tekstu w języku programowania mogą się znaleźć podpowiedzi dotyczące Javy, JavaScriptu, Pythona i C++. Gdy użytkownicy zaczną wpisywać Jav, na liście filtrów pojawią się tylko Java i JavaScript.

Sugerowane wartości pomagają zachęcać użytkowników do wpisywania wartości, które są zrozumiałe dla aplikacji. W odniesieniu do języka JavaScript niektórzy użytkownicy mogą wpisać javascript a inni java script. Sugerowanie JavaScript może ustandaryzować sposób, w jaki użytkownicy korzystają z Twojej aplikacji.

Jeśli jest określona, TextInput.type ma zawsze wartość SINGLE_LINE, nawet jeśli jest ustawiona na MULTIPLE_LINE.

autoCompleteAction

object (Action)

Opcjonalnie. Określ czynność wykonywaną, gdy pole do wprowadzania tekstu zawiera sugestie użytkownikom, którzy z niego korzystają.

Jeśli nie określono inaczej, sugestie są ustawiane przez initialSuggestions i przetwarzane przez klienta.

Jeśli zostanie określony, aplikacja wykona określone tutaj działanie, na przykład uruchomi funkcję niestandardową.

Są obsługiwane przez dodatki do Google Workspace, ale nie przez aplikacje Google Chat.

placeholderText

string

Tekst, który pojawia się w polu wprowadzania tekstu, gdy jest ono puste. Użyj tego tekstu, aby poprosić użytkowników o wpisanie wartości. Na przykład: Enter a number from 0 to 100.

Są obsługiwane przez aplikacje do Google Chat, ale nie przez dodatki do Google Workspace.

Typ

Wartości w polu enum
SINGLE_LINE Pole do wprowadzania tekstu ma stałą wysokość 1 wiersza.
MULTIPLE_LINE Pole do wprowadzania tekstu ma stałą wysokość wielu wierszy.

Działanie

Działanie opisujące zachowanie po przesłaniu formularza. Możesz na przykład wywołać skrypt Apps Script do obsługi formularza. W przypadku uruchomienia działania wartości formularza są wysyłane na serwer.

Zapis JSON
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}
Pola
function

string

Funkcja niestandardowa do wywołania po kliknięciu lub niewłaściwym aktywowaniu elementu zawierającego ten element.

Przykład wykorzystania znajdziesz w artykule o tworzeniu kart interaktywnych.

parameters[]

object (ActionParameter)

Lista parametrów działań.

loadIndicator

enum (LoadIndicator)

Określa wskaźnik wczytywania, który wyświetla się podczas wysyłania wezwania do działania.

persistValues

boolean

Wskazuje, czy wartości formularza pozostają po wykonaniu czynności. Wartością domyślną jest false.

Jeśli true, wartości formularza pozostają po wywołaniu działania. Aby umożliwić użytkownikowi wprowadzanie zmian podczas przetwarzania działania, ustaw LoadIndicator na NONE. W przypadku wiadomości z kartami w aplikacjach do obsługi czatu musisz też ustawić wartość ResponseType działania na UPDATE_MESSAGE i użyć tej samej wartości cardId co karta zawierająca działanie.

Jeśli false, wartości formularza są czyszczone po uruchomieniu działania. Aby uniemożliwić użytkownikowi wprowadzanie zmian podczas przetwarzania działania, ustaw LoadIndicator na SPINNER.

interaction

enum (Interaction)

Opcjonalnie. Wymagane przy otwieraniu okna.

Co zrobić w odpowiedzi na interakcję z użytkownikiem, np. kliknięcie przez niego przycisku w wiadomości na karcie.

Jeśli nie określono inaczej, aplikacja reaguje, wykonując action w zwykły sposób, np. otwierając link lub uruchamiając funkcję.

Dzięki określeniu interaction aplikacja może reagować w specjalny interaktywny sposób. Jeśli na przykład ustawisz w interaction wartość OPEN_DIALOG, aplikacja będzie mogła otworzyć okno. Jeśli podasz wartość, wskaźnik wczytywania się nie wyświetli.

Są obsługiwane przez aplikacje do obsługi czatu, ale nie przez dodatki do Google Workspace. Jeśli określisz dodatek, zostanie ona usunięta z całej karty i klient nie będzie niczego wyświetlać.

ActionParameter

Lista parametrów ciągu znaków, które należy podać po wywołaniu metody działania. Rozważmy na przykład trzy przyciski drzemki: „Drzemka”, „Odłóż jeden dzień” i „Drzemka” w przyszłym tygodniu. Możesz użyć właściwości action method = snooze(), która przekazuje typ drzemki i czas drzemki na liście parametrów ciągu znaków.

Więcej informacji: CommonEventObject.

Zapis JSON
{
  "key": string,
  "value": string
}
Pola
key

string

Nazwa parametru skryptu działania.

value

string

Wartość parametru.

LoadIndicator

Określa wskaźnik wczytywania, który wyświetla się podczas wysyłania wezwania do działania.

Wartości w polu enum
SPINNER Ikona wczytywania oznacza, że zawartość się wczytuje.
NONE Nic nie jest wyświetlane.

Interakcja

Opcjonalnie. Wymagane przy otwieraniu okna.

Co zrobić w odpowiedzi na interakcję z użytkownikiem, np. kliknięcie przez niego przycisku w wiadomości na karcie.

Jeśli nie określono inaczej, aplikacja reaguje, wykonując action w zwykły sposób, np. otwierając link lub uruchamiając funkcję.

Dzięki określeniu interaction aplikacja może reagować w specjalny interaktywny sposób. Jeśli na przykład ustawisz w interaction wartość OPEN_DIALOG, aplikacja będzie mogła otworzyć okno.

Jeśli podasz wartość, wskaźnik wczytywania się nie wyświetli.

Są obsługiwane przez aplikacje do obsługi czatu, ale nie przez dodatki do Google Workspace. Jeśli określisz dodatek, zostanie ona usunięta z całej karty i klient nie będzie niczego wyświetlać.

Wartości w polu enum
INTERACTION_UNSPECIFIED Wartość domyślna. action działa w zwykły sposób.
OPEN_DIALOG

Otwiera okno, czyli okno interfejsu z kartami, za pomocą którego aplikacje Google Chat mogą komunikować się z użytkownikami.

Obsługiwane tylko przez aplikacje do obsługi czatu w odpowiedzi na kliknięcia przycisków w wiadomościach kart.

Nieobsługiwane przez dodatki do Google Workspace. Jeśli określisz dodatek, zostanie ona usunięta z całej karty i klient nie będzie niczego wyświetlać.

Sugestie

Zapis JSON
{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}
Pola
items[]

object (SuggestionItem)

Lista sugestii używanych na potrzeby rekomendacji autouzupełniania w polach do wprowadzania tekstu.

SuggestionItem

Zapis JSON
{

  // Union field content can be only one of the following:
  "text": string
  // End of list of possible types for union field content.
}
Pola

Pole sumy content.

content może mieć tylko jeden z tych parametrów:

text

string

Wartość sugerowanej wartości wejściowej w polu do wprowadzania tekstu. Jest to odpowiednik haseł wpisywanych przez użytkowników.

Rozwiązywanie problemów

Gdy aplikacja lub karta Google Chat zwróci błąd, w interfejsie czatu pojawi się komunikat „Coś poszło nie tak” lub „Nie udało się przetworzyć Twojego żądania”. Czasami w interfejsie Google Chat nie pojawia się żaden komunikat o błędzie, ale aplikacja lub karta Google Chat mogą dać nieoczekiwany wynik, na przykład komunikat na karcie.

Mimo że komunikat o błędzie może nie wyświetlić się w interfejsie Google Chat, dostępne są opisowe komunikaty o błędach i dane dziennika, które pomogą Ci naprawić błędy występujące po włączeniu rejestrowania błędów w aplikacjach do obsługi czatu. Więcej informacji o wyświetlaniu, debugowaniu i naprawianiu błędów znajdziesz w artykule Rozwiązywanie problemów z Google Chat i rozwiązywanie problemów.