- Zapis JSON
- CommonEventObject
- TimeZone
- Dane wejściowe
- StringInputs:
- DateTimeInput
- DateInput
- TimeInput
Zdarzenie interakcji z aplikacją Google Chat.
Więcej informacji o zdarzeniach interakcji znajdziesz w artykule Odbieranie interakcji z aplikacją Google Chat i reagowanie na nie. Więcej informacji o typach zdarzeń i przykładowych ładunkach zdarzeń znajdziesz w artykule Rodzaje zdarzeń interakcji z aplikacją Google Chat.
Oprócz otrzymywania zdarzeń pochodzących z interakcji użytkowników aplikacje Google Chat mogą otrzymywać informacje o zmianach w pokojach, na przykład o dodaniu do pokoju nowego użytkownika. Więcej informacji o wydarzeniach w pokoju znajdziesz w artykule Praca z wydarzeniami z Google Chat.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Typ zdarzenia interakcji. Więcej informacji znajdziesz w artykule Rodzaje zdarzeń interakcji z aplikacją Google Chat. |
eventTime |
Sygnatura czasowa wskazująca, kiedy wystąpiło zdarzenie interakcji. |
token |
Wartość obiektu tajnego, której starsze aplikacje do obsługi czatu mogą używać do weryfikowania, czy żądanie pochodzi od Google. Google generuje ten token losowo, a jego wartość pozostaje statyczna. Możesz uzyskać, unieważnić lub ponownie wygenerować token na stronie konfiguracji interfejsu Chat API w konsoli Google Cloud. Współczesne aplikacje do obsługi czatu nie używają tego pola. Nie występuje on w odpowiedziach interfejsu API ani na stronie konfiguracji interfejsu Chat API. |
threadKey |
Klucz zdefiniowany przez aplikację do obsługi czatu dla wątku powiązanego ze zdarzeniem interakcji. Więcej informacji: |
message |
Wiadomość, która wywołała zdarzenie interakcji (w stosownych przypadkach). |
user |
Użytkownik, który wywołał zdarzenie interakcji. |
space |
Pokój, w którym wystąpiło zdarzenie interakcji. |
action |
W przypadku zdarzeń interakcji |
configCompleteRedirectUrl |
Adres URL, na który aplikacja Google Chat powinna przekierowywać użytkownika po zakończeniu procesu autoryzacji lub konfiguracji poza Google Chat. Więcej informacji znajdziesz w artykule Łączenie aplikacji Google Chat z innymi usługami i narzędziami. |
isDialogEvent |
W przypadku zdarzeń interakcji |
dialogEventType |
Typ odebranego zdarzenia interakcji okno. |
common |
Przedstawia informacje o kliencie użytkownika, takie jak język, aplikacja hosta i platforma. W przypadku aplikacji do obsługi czatu |
CommonEventObject
Przedstawia informacje o kliencie użytkownika, takie jak język, aplikacja hosta i platforma. W przypadku aplikacji do obsługi czatu CommonEventObject
uwzględnia dane przesłane przez użytkowników korzystających z kart, np. dane wpisywane w oknach dialogowych.
Zapis JSON |
---|
{ "userLocale": string, "hostApp": enum ( |
Pola | |
---|---|
userLocale |
Pełna wartość |
hostApp |
Lista hostApp, która wskazuje aplikację, z której jest wywoływany dodatek. W przypadku aplikacji do obsługi czatu zawsze |
platform |
Lista platform, która wskazuje platformę, z której pochodzi zdarzenie ( |
timeZone |
Identyfikator strefy czasowej i przesunięcie względem uniwersalnego czasu koordynowanego (UTC). Obsługiwane tylko w przypadku typów zdarzeń |
formInputs |
Mapa zawierająca wartości wpisane przez użytkownika w widżecie z karty lub okna. Klucze mapy to identyfikatory ciągu przypisane do każdego widżetu. Wartości reprezentują dane wejściowe widżetu. Więcej informacji znajdziesz w artykule Informacje o procesie podawane przez użytkowników. |
parameters |
Niestandardowe parametry przekazywane do wywoływanej funkcji. Zarówno klucze, jak i wartości muszą być ciągami tekstowymi. |
invokedFunction |
Nazwa wywołanej funkcji powiązanej z widżetem. Ustawiona tylko dla 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 strefy czasowej IANA TZ, np. „Ameryka/Toronto”. |
offset |
Przesunięcie strefy czasowej użytkownika w milisekundach względem uniwersalnego czasu koordynowanego (UTC). |
Dane wejściowe
Rodzaje danych, które użytkownicy mogą podawać na kartach lub w oknach dialogowych. Typ danych wejściowych zależy od typu wartości akceptowanych przez widżet.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
|
|
stringInputs |
Lista ciągów znaków reprezentujących wartości wpisywane przez użytkownika w widżecie. Jeśli widżet akceptuje tylko jedną wartość, na przykład widżet |
dateTimeInput |
Wartości wejściowe daty i godziny z widżetu |
dateInput |
Wartości wejściowe daty z widżetu |
timeInput |
Wartości czasowe z widżetu |
StringInputs
Parametr wejściowy dla zwykłych widżetów. W przypadku widżetów jednowartościowych jest to lista wartości. W przypadku widżetów o wielu wartościach, np. pól wyboru, przedstawiane są wszystkie wartości.
Zapis JSON |
---|
{ "value": [ string ] } |
Pola | |
---|---|
value[] |
Lista ciągów tekstowych wprowadzonych przez użytkownika. |
DateTimeInput
Wartości wejściowe daty i godziny.
Zapis JSON |
---|
{ "msSinceEpoch": string, "hasDate": boolean, "hasTime": boolean } |
Pola | |
---|---|
msSinceEpoch |
Czas od początku epoki w milisekundach. |
hasDate |
Określa, czy pole |
hasTime |
Określa, czy dane wejściowe |
DateInput
Wartości wejściowe daty.
Zapis JSON |
---|
{ "msSinceEpoch": string } |
Pola | |
---|---|
msSinceEpoch |
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. |