Event

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Wydarzenia w Google Chat.

Zapis JSON
{
  "type": enum (EventType),
  "eventTime": string,
  "token": string,
  "threadKey": string,
  "message": {
    object (Message)
  },
  "user": {
    object (User)
  },
  "space": {
    object (Space)
  },
  "action": {
    object (FormAction)
  },
  "configCompleteRedirectUrl": string,
  "isDialogEvent": boolean,
  "dialogEventType": enum (DialogEventType),
  "common": {
    object (CommonEventObject)
  }
}
Pola
type

enum (EventType)

Typ zdarzenia.

eventTime

string (Timestamp format)

Sygnatura czasowa wskazująca, kiedy wystąpiło zdarzenie.

token

string

Tajna wartość, której starsze aplikacje do obsługi czatu mogą używać do weryfikowania, czy żądanie pochodzi od Google. Google losowo wygeneruje token, a jego wartość pozostanie statyczna. Token możesz uzyskać, unieważnić lub wygenerować ponownie na stronie konfiguracji interfejsu Chat API w Google Cloud Console.

Nowoczesne aplikacje do obsługi czatu nie używają tego pola. Brakuje go w odpowiedziach na interfejs API i na stronie konfiguracji interfejsu Chat API.

threadKey

string

Zdefiniowany przez aplikację Google Chat klucz wątku powiązany ze zdarzeniem. Więcej informacji znajdziesz w polu spaces.messages.thread.threadKey.

message

object (Message)

Komunikat, który wywołał zdarzenie (w stosownych przypadkach).

user

object (User)

Użytkownik, który wywołał zdarzenie.

space

object (Space)

Przestrzeń, w której wystąpiło zdarzenie.

action

object (FormAction)

Dane dotyczące działania formularza powiązanego z klikniętą kartą interaktywną. Wypełniane tylko w przypadku CARD_CLICKED zdarzeń. Więcej informacji znajdziesz w przewodniku po kartach interaktywnych.

configCompleteRedirectUrl

string

Adres URL, pod którym aplikacja Google Chat powinna przekierowywać użytkownika po zakończeniu procesu autoryzacji lub konfiguracji poza Google Chat. Więcej informacji znajdziesz w przewodniku po autoryzowaniu dostępu do usług innych firm.

isDialogEvent

boolean

Wartość to „prawda”, gdy zdarzenie jest związane z dialogami.

dialogEventType

enum (DialogEventType)

Typ otrzymanego zdarzenia dialog.

common

object (CommonEventObject)

Reprezentuje informacje o kliencie użytkownika, takie jak język, aplikacja hosta i platforma. W przypadku aplikacji do obsługi czatu CommonEventObject uwzględnia informacje przesłane przez użytkowników korzystających z dialogów, takie jak dane podane na karcie.

CommonEventObject

Reprezentuje informacje o kliencie użytkownika, takie jak język, aplikacja hosta i platforma. W przypadku aplikacji do obsługi czatu CommonEventObject obejmuje dane przesłane przez użytkowników korzystających z kart, takie jak dane wpisane w dialogach.

Zapis JSON
{
  "userLocale": string,
  "hostApp": enum (HostApp),
  "platform": enum (Platform),
  "timeZone": {
    object (TimeZone)
  },
  "formInputs": {
    string: {
      object (Inputs)
    },
    ...
  },
  "parameters": {
    string: string,
    ...
  },
  "invokedFunction": string
}
Pola
userLocale

string

Pełny kod locale.displayName w formacie [kod języka w formacie ISO 639]-[kod kraju/regionu ISO 3166], np. „pl-PL”. Nieobsługiwane w aplikacjach Google Chat.

hostApp

enum (HostApp)

Lista hosta HostApp wskazująca, z której aplikacji jest wywoływany dodatek. Zawsze CHAT w przypadku aplikacji do obsługi czatu.

platform

enum (Platform)

Wyliczenie platformy, na którym znajduje się zdarzenie (WEB, IOS lub ANDROID). Nieobsługiwane przez aplikacje do obsługi czatu.

timeZone

object (TimeZone)

Identyfikator strefy czasowej i przesunięcie od czasu UTC (uniwersalnego czasu koordynowanego).

formInputs

map (key: string, value: object (Inputs))

Mapa zawierająca bieżące wartości widżetów na karcie. Klucze map to identyfikatory ciągów znaków przypisane do każdego widżetu. Wartości reprezentują dane wejściowe widżetu. W zależności od typu danych wejściowych każdy obiekt jest reprezentowany przez inny obiekt: StringInput. W przypadku widżetów z wieloma wartościami jest to tablica obiektów StringInput. W przypadku selektora daty i godziny DateTimeInput W przypadku selektora dat tylko DateInput. W przypadku selektora czasowego: TimeInput. Odpowiada danem wpisanym przez użytkownika na karcie w oknie.

parameters

map (key: string, value: string)

Niestandardowe parametry przekazywane do wywoływanej funkcji. Zarówno klucze, jak i wartości muszą być ciągami znaków.

invokedFunction

string

Nazwa wywołanej funkcji powiązanej z widżetem. Ustawiono tylko dla aplikacji do obsługi czatu.

TimeZone

Identyfikator strefy czasowej i przesunięcie od czasu UTC (uniwersalnego czasu koordynowanego). Nieobsługiwane w aplikacjach Google Chat.

Zapis JSON
{
  "id": string,
  "offset": integer
}
Pola
id

string

Kod bazy danych strefy czasowej IANA TZ, np. „Ameryka/Toronto”.

offset

integer

Przesunięcie strefy czasowej użytkownika (w milisekundach) od uniwersalnego czasu koordynowanego (UTC).

Dane wejściowe

Rodzaje danych wejściowych widżetów. Użytkownicy wprowadzają dane z tymi danymi.

Zapis JSON
{

  // Union field inputs can be only one of the following:
  "stringInputs": {
    object (StringInputs)
  },
  "dateTimeInput": {
    object (DateTimeInput)
  },
  "dateInput": {
    object (DateInput)
  },
  "timeInput": {
    object (TimeInput)
  }
  // End of list of possible types for union field inputs.
}
Pola

Pole sumy: inputs.

inputs może mieć tylko jedną z tych wartości:

stringInputs

object (StringInputs)

Parametr wejściowych standardowych widżetów. W przypadku widżetów z jedną wartością jest to lista pojedynczych wartości. W przypadku widżetów z wieloma wartościami, takich jak pole wyboru, wyświetlają się wszystkie wartości.

dateTimeInput

object (DateTimeInput)

Data i godzina. Nieobsługiwane w aplikacjach Google Chat.

dateInput

object (DateInput)

Data. Nieobsługiwane w aplikacjach Google Chat.

timeInput

object (TimeInput)

Wartości wejściowe czasu. Nieobsługiwane w aplikacjach Google Chat.

Wejścia ciągu znaków

Parametr wejściowych standardowych widżetów. W przypadku widżetów z jedną wartością jest to lista pojedynczych wartości. W przypadku widżetów z wieloma wartościami, takich jak pole wyboru, wyświetlają się wszystkie wartości.

Zapis JSON
{
  "value": [
    string
  ]
}
Pola
value[]

string

Tablica ciągów wpisanych przez użytkownika.

Data i godzina

Data i godzina. Nieobsługiwane w aplikacjach Google Chat.

Zapis JSON
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
Pola
msSinceEpoch

string (int64 format)

Czas od początku epoki (w milisekundach).

hasDate

boolean

Określa, czy dane wejściowe datetime mają datę kalendarzową.

hasTime

boolean

Określa, czy dane wejściowe datetime mają sygnaturę czasową.

Dane wejściowe daty

Data. Nieobsługiwane w aplikacjach Google Chat.

Zapis JSON
{
  "msSinceEpoch": string
}
Pola
msSinceEpoch

string (int64 format)

Czas od początku epoki (w milisekundach).

Dane wejściowe czasu

Wartości wejściowe czasu. Nieobsługiwane w aplikacjach Google Chat.

Zapis JSON
{
  "hours": integer,
  "minutes": integer
}
Pola
hours

integer

Godzina na zegarze 24-godzinnym.

minutes

integer

Liczba minut po godzinie. Prawidłowe wartości to od 0 do 59.