Karta
Karta to element interfejsu, który może zawierać widżety interfejsu takie jak tekst czy obrazy.
Zapis JSON |
---|
{ "header": { object ( |
Pola | |
---|---|
header
|
Nagłówek karty. Nagłówek zwykle zawiera tytuł i obraz. |
sections[]
|
Sekcje są rozdzielone linią. |
cardActions[]
|
Działania na tej karcie. |
name
|
Nazwa karty. |
CardHeader
Zapis JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
Pola | |
---|---|
title
|
Należy podać tytuł. Nagłówek ma stałą wysokość: jeśli określono zarówno tytuł, jak i podtytuł, każdy z nich zajmuje po jednym wierszu. Jeśli określono tylko tytuł, tekst zajmuje oba wiersze. |
subtitle
|
Podtytuł nagłówka karty. |
imageStyle
|
Typ obrazu (np. kwadratowe lub okrągłe obramowanie). |
imageUrl
|
Adres URL obrazu w nagłówku karty. |
ImageStyle
Wartości w polu enum | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Kwadratowe obramowanie. |
AVATAR
|
Obramowanie okrągłe. |
Sekcja
Sekcja zawiera zbiór widżetów, które są renderowane (w pionie) w określonej kolejności. Na wszystkich platformach karty mają wąską stałą szerokość, więc obecnie nie trzeba stosować właściwości układu (np. kreacji zmiennoprzecinkowych).
Zapis JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
Pola | |
---|---|
header
|
Nagłówek sekcji. Tekst sformatowany jest obsługiwany. Więcej informacji o formatowaniu tekstu znajdziesz w sekcji Formatowanie tekstu w aplikacjach Google Chat oraz Formatowanie tekstu w dodatkach do Google Workspace |
widgets[]
|
Sekcja musi zawierać co najmniej jeden widżet. |
WidgetMarkup
Widżet to element interfejsu, który prezentuje tekst i obrazy.
Zapis JSON |
---|
{ "buttons": [ { object ( |
Pola | |
---|---|
buttons[]
|
Lista przycisków. Przyciski są również
|
Pole sumy
data O
WidgetMarkup
może zawierać tylko jeden z następujących elementów. Możesz używać wielu
WidgetMarkup
aby wyświetlić więcej elementów.
data
może być tylko jednym z tych elementów:
|
|
textParagraph
|
Wyświetla akapit tekstu w tym widżecie. |
image
|
Wyświetlaj obraz w tym widżecie. |
keyValue
|
Wyświetla element pary klucz-wartość w tym widżecie. |
TextParagraph
Akapit tekstu. Sformatowany tekst jest obsługiwany. Więcej informacji o formatowaniu tekstu znajdziesz w sekcji Formatowanie tekstu w aplikacjach Google Chat oraz Formatowanie tekstu w dodatkach do Google Workspace
Zapis JSON |
---|
{ "text": string } |
Pola | |
---|---|
text
|
|
Obraz
Obraz określony za pomocą adresu URL i może mieć atrybut
onclick
działania.
Zapis JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Pola | |
---|---|
imageUrl
|
Adres URL obrazu. |
onClick
|
|
aspectRatio
|
Format obrazu (szerokość i wysokość). To pole umożliwia zarezerwowanie odpowiedniej wysokości obrazu podczas oczekiwania na jego wczytanie. Nie zastępuje on wbudowanego formatu obrazu. Jeśli zasada jest nieskonfigurowana, serwer wypełnia ją, pobierając obraz z wyprzedzeniem. |
OnClick
An
onclick
działanie (np. otwarcie linku).
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
|
|
action
|
Działanie formularza jest wywoływane przez
|
openLink
|
Ten
|
FormAction
Działanie związane z formularzem opisuje zachowanie po przesłaniu formularza. Możesz na przykład wywołać Apps Script, aby obsłużyć formularz.
Zapis JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
Pola | |
---|---|
actionMethodName
|
Nazwa metody służy do określenia, która część formularza spowodowała jego przesłanie. Te informacje są odczytywane w aplikacji Google Chat w ramach zdarzenia kliknięcia karty. Tej samej nazwy metody możesz użyć w przypadku kilku elementów, które wywołują typowe zachowanie. |
parameters[]
|
Lista parametrów działań. |
ActionParameter
Lista parametrów ciągu znaków, które mają być podawane po wywołaniu metody działania. Weźmy na przykład 3 przyciski drzemki: Odłóż teraz, Odłóż jeden dzień i Odłóż w przyszłym tygodniu. Możesz użyć
action method = snooze()
przekazuje typ drzemki i czas drzemki na liście parametrów ciągu znaków.
Zapis JSON |
---|
{ "key": string, "value": string } |
Pola | |
---|---|
key
|
Nazwa parametru skryptu działania. |
value
|
Wartość parametru. |
OpenLink
Link otwierający nowe okno.
Zapis JSON |
---|
{ "url": string } |
Pola | |
---|---|
url
|
Adres URL do otwarcia. |
KeyValue
Element interfejsu zawiera klucz (etykietę) i wartość (treść). Ten element może też zawierać niektóre działania, na przykład
onclick
Przycisk
Zapis JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Pola | |
---|---|
topLabel
|
Tekst etykiety u góry. Sformatowany tekst jest obsługiwany. Więcej informacji o formatowaniu tekstu znajdziesz w sekcji Formatowanie tekstu w aplikacjach Google Chat oraz Formatowanie tekstu w dodatkach do Google Workspace |
content
|
Tekst treści. Sformatowany tekst jest obsługiwany i zawsze wymagany. Więcej informacji o formatowaniu tekstu znajdziesz w sekcji Formatowanie tekstu w aplikacjach Google Chat oraz Formatowanie tekstu w dodatkach do Google Workspace |
contentMultiline
|
Czy treść powinna być wielowierszowa. |
bottomLabel
|
Tekst dolnej etykiety. Sformatowany tekst jest obsługiwany. Więcej informacji o formatowaniu tekstu znajdziesz w sekcji Formatowanie tekstu w aplikacjach Google Chat oraz Formatowanie tekstu w dodatkach do Google Workspace |
onClick
|
|
Pole sumy
icons Przynajmniej jedna z tych ikon,
top_label
oraz
bottom_label
musi być zdefiniowany.
icons
może być tylko jednym z tych elementów:
|
|
icon
|
Wartość wyliczeniowa, którą zastępuje Chat API odpowiednim obrazem ikony. |
iconUrl
|
Ikona określona przez adres URL. |
Pole sumy
control Widżet sterujący. Możesz wybrać jedną z tych opcji
button
lub
switch_widget , ale nie jedno i drugie.
control
może być tylko jednym z tych elementów:
|
|
button
|
Przycisk, który można kliknąć, aby wywołać działanie. |
Ikona
Zestaw obsługiwanych ikon.
Wartości w polu enum | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
Przycisk
Przycisk. Może to być przycisk tekstowy lub graficzny.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
|
|
textButton
|
Przycisk z tekstem
|
imageButton
|
Przycisk z obrazem
|
TextButton
Przycisk z tekstem
onclick
działania.
Zapis JSON |
---|
{
"text": string,
"onClick": {
object (
|
Pola | |
---|---|
text
|
Tekst na przycisku. |
onClick
|
|
ImageButton
Przycisk graficzny ze znakiem
onclick
działania.
Zapis JSON |
---|
{ "onClick": { object ( |
Pola | |
---|---|
onClick
|
|
name
|
Nazwa elementu
|
Pole sumy
icons Ikonę można określić za pomocą
Icon
enum
lub adres URL.
icons
może być tylko jednym z tych elementów:
|
|
icon
|
Ikona wskazana przez tag
|
iconUrl
|
Ikona określona przez adres URL. |
CardAction
Działanie związane z kartą to działanie powiązane z kartą. W przypadku karty faktury typowe działanie to: usunięcie faktury, wysłanie jej e-mailem lub otwarcie faktury w przeglądarce.
Nie są obsługiwane przez aplikacje Google Chat.
Zapis JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
Pola | |
---|---|
actionLabel
|
Etykieta, która była wyświetlana w menu czynności. |
onClick
|
Działanie „onclick” dla tego działania. |