- Zapis JSON
- CommonEventObject
- Strefa czasowa
- Dane wejściowe
- StringInputs
- DateTimeInput
- DateInput
- TimeInput
Zdarzenie interakcji z aplikacją Google Chat, które reprezentuje interakcję użytkownika z aplikacją do obsługi czatu i zawiera dane na jej temat. Jeśli chcesz skonfigurować aplikację Google Chat do odbierania zdarzeń interakcji, przeczytaj artykuł Odbieranie interakcji z użytkownikiem i reagowanie na nie.
Oprócz otrzymywania zdarzeń z interakcji użytkowników aplikacje do obsługi czatu mogą też otrzymywać zdarzenia dotyczące zmian w pokojach, na przykład informacje o dodaniu do pokoju nowego użytkownika. Więcej informacji o zdarzeniach w pokoju znajdziesz w artykule Praca ze zdarzeniami w Google Chat.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Typ interakcji użytkownika z aplikacją Google Chat, na przykład |
event |
Znak czasowy wskazujący, kiedy wystąpiło zdarzenie interakcji. |
token |
Tajna wartość, której starsze wersje aplikacji Chat mogą używać do sprawdzania, czy żądanie pochodzi od Google. Google losowo generuje token, a jego wartość pozostaje statyczna. Token możesz uzyskać, unieważnić lub ponownie wygenerować na stronie konfiguracji interfejsu Chat API w Google Cloud Console. Nowoczesne aplikacje do obsługi czatu nie używają tego pola. Nie jest ona dostępna w odpowiedziach interfejsu API ani na stronie konfiguracji interfejsu Chat API. |
thread |
Klucz zdefiniowany przez aplikację w Google Chat dla wątku związanego ze zdarzeniem interakcji. Więcej informacji znajdziesz w artykule |
message |
W przypadku zdarzeń interakcji |
user |
Użytkownik, który wszedł w interakcję z aplikacją Google Chat. |
space |
Pokój, w którym użytkownik wchodził w interakcję z aplikacją Google Chat. |
action |
W przypadku zdarzeń interakcji |
config |
W przypadku zdarzeń interakcji z funkcją |
is |
W przypadku zdarzeń interakcji |
dialog |
Typ odebranego zdarzenia interakcji w oknie. |
common |
Reprezentuje informacje o kliencie użytkownika, takie jak lokalizacja, aplikacja hosta i platforma. W przypadku aplikacji do obsługi czatu |
CommonEventObject
Zawiera informacje o kliencie użytkownika, np. język, aplikację hostującą i platformę. W przypadku aplikacji do obsługi czatu CommonEventObject
obejmuje dane przesłane przez użytkowników, którzy korzystają z kart, np. dane wpisane w oknach dialogowych.
Zapis JSON |
---|
{ "userLocale": string, "hostApp": enum ( |
Pola | |
---|---|
user |
Pełny kod |
host |
Wyliczenie hostApp wskazujące aplikację, z której jest wywoływany dodatek. Zawsze |
platform |
Wyliczenie platformy, które wskazuje platformę, z której pochodzi zdarzenie ( |
time |
Identyfikator strefy czasowej i odsunięcie względem uniwersalnego czasu koordynowanego (UTC). Obsługiwane tylko w przypadku typów zdarzeń |
form |
Mapa zawierająca wartości, które użytkownik wpisuje w widżecie na karcie lub w dialogu. Klucze mapy to identyfikatory ciągu znaków przypisane do poszczególnych widżetów, a wartości to dane wejściowe widżetów. Szczegółowe informacje znajdziesz w sekcji Informacje o procesach wprowadzane przez użytkowników. |
parameters |
Parametry niestandardowe przekazywane do wywołanej funkcji. Klucze i wartości muszą być ciągami znaków. |
invoked |
Nazwa wywołanej funkcji powiązanej z widżetem. Ustawiane tylko w przypadku aplikacji Google Chat. |
TimeZone
Identyfikator strefy czasowej i przesunięcie względem uniwersalnego czasu koordynowanego (UTC). Obsługiwane tylko w przypadku typów zdarzeń CARD_CLICKED
i SUBMIT_DIALOG
.
Zapis JSON |
---|
{ "id": string, "offset": integer } |
Pola | |
---|---|
id |
Kod bazy danych stref czasowych IANA TZ, np. „America/Toronto”. |
offset |
Odchylenie strefy czasowej użytkownika od uniwersalnego czasu koordynowanego (UTC) w milisekundach. |
Dane wejściowe
Typy danych, które użytkownicy mogą wprowadzać na kartach lub w dialogach. Typ danych wejściowych zależy od typu wartości akceptowanych przez widżet.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole unii
|
|
string |
Lista ciągów tekstowych, które reprezentują wartości wprowadzane przez użytkownika w widżecie. Jeśli widżet akceptuje tylko jedną wartość, np. widżet |
date |
Data i godzina pochodzą z widżetu |
date |
wartości danych daty z widżetu |
time |
wartości wejściowe czasu z widżetu |
StringInputs
Parametr do wprowadzania zwykłych widżetów. W przypadku widżetów jednowartościowych jest to jedna lista wartości. W przypadku widżetów z wieloma wartościami, np. pola wyboru, wyświetlane są wszystkie wartości.
Zapis JSON |
---|
{ "value": [ string ] } |
Pola | |
---|---|
value[] |
Lista ciągów znaków wpisanych przez użytkownika. |
DateTimeInput
wartości danych wejściowych daty i godziny;
Zapis JSON |
---|
{ "msSinceEpoch": string, "hasDate": boolean, "hasTime": boolean } |
Pola | |
---|---|
ms |
Czas od początku epoki w milisekundach. |
has |
Określa, czy dane wejściowe |
has |
Określa, czy dane wejściowe |
DateInput
Wartości danych wejściowych daty.
Zapis JSON |
---|
{ "msSinceEpoch": string } |
Pola | |
---|---|
ms |
Czas od początku epoki w milisekundach. |
TimeInput
Dane wejściowe czasu.
Zapis JSON |
---|
{ "hours": integer, "minutes": integer } |
Pola | |
---|---|
hours |
Godzina na zegarze 24-godzinnym. |
minutes |
Liczba minut w ciągu ostatniej godziny. Prawidłowe wartości to od 0 do 59. |