- Zapis JSON
- CommonEventObject
- TimeZone
- Wejścia
- StringInputs
- DateTimeInput
- DateInput
- TimeInput
- AppCommandMetadata
Zdarzenie interakcji z aplikacją Google Chat, które reprezentuje i zawiera dane o interakcji użytkownika z aplikacją Google Chat. Aby skonfigurować aplikację Google Chat tak, aby odbierała zdarzenia interakcji, zapoznaj się z artykułem Otrzymywanie i odpowiadanie na interakcje użytkowników.
Oprócz otrzymywania zdarzeń z interakcji użytkowników aplikacje do obsługi czatu mogą otrzymywać zdarzenia dotyczące zmian w pokojach, np. gdy do pokoju dodany zostanie nowy użytkownik. Więcej informacji o zdarzeniach w pokoju znajdziesz w artykule Praca z wydarzeniami z Google Chat.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Typ interakcji użytkownika z aplikacją Chat, np. |
event |
Znak czasowy wskazujący, kiedy wystąpiło zdarzenie interakcji. |
token |
Tajna wartość, której starsze wersje aplikacji Google Chat mogą używać do sprawdzania, czy żądanie pochodzi od Google. Google generuje token losowo, a jego wartość pozostaje statyczna. Token możesz uzyskać, cofnąć lub wygenerować ponownie na stronie konfiguracji interfejsu API Chata w konsoli Google Cloud. 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ę do obsługi czatu dla wątku powią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 |
is |
W przypadku zdarzeń interakcji |
dialog |
Typ otrzymanego zdarzenia interakcji dialogu. |
common |
Reprezentuje informacje o kliencie użytkownika, takie jak lokalizacja, aplikacja hosta i platforma. W przypadku aplikacji do czatu |
app |
Wypełnione dla poleceń aplikacji, w tym poleceń po ukośniku i szybkich poleceń. |
CommonEventObject
Reprezentuje informacje o kliencie użytkownika, takie jak lokalizacja, aplikacja hosta i platforma. W przypadku aplikacji do czatu CommonEventObject
obejmuje dane przesłane przez użytkowników, którzy wchodzą w interakcję z kartami, np. dane wprowadzone w dialogach.
Zapis JSON |
---|
{ "userLocale": string, "hostApp": enum ( |
Pola | |
---|---|
user |
Pełna wartość |
host |
Wyliczenie hostApp, które wskazuje aplikację, z której wywoływany jest dodatek. Zawsze |
platform |
Wyliczenie platformy, które wskazuje platformę, z której pochodzi zdarzenie ( |
time |
Identyfikator strefy czasowej i przesunię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 artykule Przetwarzanie informacji wprowadzanych przez użytkowników. |
parameters |
niestandardowe parametry przekazane do wywoływanej funkcji; Klucze i wartości muszą być ciągami znaków. |
invoked |
Nazwa wywoływanej 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 widget.
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 |
wartości danych wejściowych daty i godziny z widżetu |
date |
wartości danych daty z widżetu |
time |
wartości wejściowe czasu z widżetu |
StringInputs
Parametr wejściowy dla zwykłych widżetów. W przypadku widżetów o pojedynczej wartości jest to lista o jednej 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
Wartości wejściowe czasu.
Zapis JSON |
---|
{ "hours": integer, "minutes": integer } |
Pola | |
---|---|
hours |
Godzina na zegarze 24-godzinnym. |
minutes |
Liczba minut po godzinie. Prawidłowe wartości to od 0 do 59. |
AppCommandMetadata
Metadane powiązane z poleceniami aplikacji. Polecenia aplikacji to sposób, w jaki użytkownicy mogą wywoływać aplikację Google Chat i wchodzić z nią w interakcję. Mogą to być polecenia z ukośnikiem wpisywane w polu tworzenia lub elementy wybrane bezpośrednio z menu integracji.
Zapis JSON |
---|
{
"appCommandId": integer,
"appCommandType": enum ( |
Pola | |
---|---|
app |
Identyfikator polecenia dla danej interakcji z aplikacją. |
app |
Typ polecenia aplikacji. |