Karta
Karta to element interfejsu, który może zawierać widżety interfejsu, takie jak tekst i obrazy.
Zapis JSON |
---|
{ "header": { object ( |
Pola | |
---|---|
header
|
Nagłówek karty. Nagłówek zwykle zawiera tytuł i obraz. |
sections[]
|
Sekcje są rozdzielone linią separatora. |
cardActions[]
|
Działania na tej karcie. |
name
|
Nazwa karty. |
CardHeader
Zapis JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
Pola | |
---|---|
title
|
Należy określić tytuł. Nagłówek ma stałą wysokość: jeśli określono zarówno tytuł, jak i podtytuł, każdy z nich zajmuje 1 wiersz. Jeśli określisz tylko tytuł, zajmie on oba wiersze. |
subtitle
|
Podtytuł karty. |
imageStyle
|
Typ obrazu (na przykład kwadratowe obramowanie lub okrągłe obramowanie). |
imageUrl
|
Adres URL obrazu w nagłówku karty. |
ImageStyle
Wartości w polu enum | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Obramowanie kwadratowe. |
AVATAR
|
Obramowanie okrągłe. |
Sekcja
Sekcja zawiera kolekcję widżetów, które są renderowane (w pionie) w określonej kolejności. Na wszystkich platformach karty mają stałą szerokość, więc obecnie nie trzeba określać właściwości układu (np. liczby zmiennoprzecinkowej).
Zapis JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
Pola | |
---|---|
header
|
Nagłówek sekcji. Obsługiwany jest sformatowany tekst. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace. |
widgets[]
|
Sekcja musi zawierać co najmniej jeden widżet. |
WidgetMarkup
Widżet to element interfejsu prezentujący tekst i obrazy.
Zapis JSON |
---|
{ "buttons": [ { object ( |
Pola | |
---|---|
buttons[]
|
Lista przycisków. Przyciski również mają wartość |
Pole sumy data . Element WidgetMarkup może mieć tylko 1 z tych elementów. Aby wyświetlić więcej elementów, możesz użyć wielu pól WidgetMarkup .
data może mieć tylko jedną z tych wartości:
|
|
textParagraph
|
Wyświetlaj akapit tekstu w tym widżecie. |
image
|
Wyświetl obraz w tym widżecie. |
keyValue
|
Wyświetlaj element par klucz-wartość w tym widżecie. |
TextParagraph
Akapit tekstu. Obsługiwany jest format tekstu. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.
Zapis JSON |
---|
{ "text": string } |
Pola | |
---|---|
text
|
|
Obraz
Obraz określony przez adres URL i który może mieć działanie onclick
.
Zapis JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Pola | |
---|---|
imageUrl
|
Adres URL obrazu. |
onClick
|
Działanie |
aspectRatio
|
Współczynnik proporcji tego obrazu (szerokość i wysokość). To pole umożliwia zarezerwowanie odpowiedniej wysokości obrazu podczas oczekiwania na jego wczytanie. Nie zastępują one wbudowanego współczynnika proporcji obrazu. Jeśli zasada jest nieskonfigurowana, serwer wypełnia ją przez pobieranie obrazu z wyprzedzeniem. |
OnClick
Działanie onclick
(np. otwarcie linku).
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
|
|
action
|
Działanie formularza jest aktywowane przez to działanie |
openLink
|
To działanie |
FormAction
Działanie dotyczące formularza opisuje zachowanie po jego przesłaniu. Możesz na przykład wywołać Apps Script do obsługi formularza.
Zapis JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
Pola | |
---|---|
actionMethodName
|
Nazwa metody służy do określania, która część formularza spowodowała przesłanie formularza. Te informacje są odczytywane do aplikacji Google Chat jako część zdarzenia kliknięcia karty. Tej samej nazwy metody możesz używać dla kilku elementów wywołujących te same zachowania. |
parameters[]
|
Lista parametrów działań. |
ActionParameter
Lista parametrów ciągu znaków, które mają zostać dostarczone po wywołaniu metody działania. Rozważmy na przykład 3 przyciski drzemki: Drzemka teraz, Drzemka o jednym dniu, Drzemka w przyszłym tygodniu. Możesz użyć właściwości action method = snooze()
, aby przekazywać typ drzemki i czas drzemki na liście parametrów w postaci 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 (etykieta) i wartość (treść). Ten element może też zawierać niektóre działania, np. przycisk onclick
.
Zapis JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Pola | |
---|---|
topLabel
|
Tekst górnej etykiety. Obsługiwany jest format tekstu. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i 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 artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace. |
contentMultiline
|
Czy treść powinna być wielowierszowa. |
bottomLabel
|
Tekst dolnej etykiety. Obsługiwany jest format tekstu. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace. |
onClick
|
Działanie |
Pole sumy icons . Musisz zdefiniować co najmniej jedną z ikon top_label i bottom_label .
icons może mieć tylko jedną z tych wartości:
|
|
icon
|
Wartość wyliczenia, która jest zastępowana przez interfejs Chat API odpowiednim obrazem ikony. |
iconUrl
|
Ikona określona przez adres URL. |
Pole sumy control . Widżet sterujący. Możesz ustawić wartość button lub switch_widget , ale nie obie te wartości.
control może mieć tylko jedną z tych wartości:
|
|
button
|
Przycisk, który może wywoływać 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 i działaniem |
imageButton
|
Przycisk z obrazem i działaniem |
TextButton
Przycisk z tekstem i działaniem onclick
.
Zapis JSON |
---|
{
"text": string,
"onClick": {
object (
|
Pola | |
---|---|
text
|
Tekst na przycisku. |
onClick
|
Działanie przycisku |
ImageButton
Przycisk graficzny z działaniem onclick
.
Zapis JSON |
---|
{ "onClick": { object ( |
Pola | |
---|---|
onClick
|
Działanie |
name
|
Nazwa tego obiektu ( |
Pole sumy icons . Ikonę można określić za pomocą właściwości Icon
enum lub adresu URL.
icons może mieć tylko jedną z tych wartości:
|
|
icon
|
Ikona określona przez obiekt |
iconUrl
|
Ikona określona przez adres URL. |
CardAction
Działanie karty to działanie powiązane z kartą. W przypadku karty faktury zazwyczaj działanie to: usunięcie faktury, wysłanie faktury e-mail lub otwarcie faktury w przeglądarce.
Nieobsł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. |