Karta
Karta to element interfejsu, który może zawierać widżety 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 separatorami liniowymi. |
cardActions[]
|
Działania dostępne na tej karcie. |
name
|
Nazwa karty. |
Nagłówek karty
Zapis JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
Pola | |
---|---|
title
|
Musisz podać tytuł. Nagłówek ma stałą wysokość: jeśli podasz zarówno tytuł, jak i podtytuł, każdy z nich będzie zajmować jeden wiersz. Jeśli podasz tylko tytuł, będzie on obejmować oba wiersze. |
subtitle
|
Podtytuł nagłówka karty. |
imageStyle
|
Typ obrazu (na przykład obramowanie kwadratowe lub okrągłe). |
imageUrl
|
Adres URL obrazu w nagłówku karty. |
Styl obrazu
Wartości w polu enum | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Obramowanie kwadratowe. |
AVATAR
|
Obramowanie okrągłe. |
Sekcja
Sekcja zawiera kolekcję widżetów (wyrenderowanych w pionie) w kolejności, w jakiej zostały określone. Na wszystkich platformach karty mają wąską stałą szerokość, więc nie trzeba obecnie stosować właściwości układu (np. liczb zmiennoprzecinkowych).
Zapis JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
Pola | |
---|---|
header
|
Nagłówek sekcji. Formatowanie tekstu jest obsługiwane. Więcej informacji znajdziesz w sekcjach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace. |
widgets[]
|
Sekcja musi zawierać co najmniej jeden widżet. |
Znacznik widżetu
Widżet to element interfejsu prezentujący tekst i obrazy.
Zapis JSON |
---|
{ "buttons": [ { object ( |
Pola | |
---|---|
buttons[]
|
Lista przycisków. Przyciski też mają wartość |
Pole sumy: data . Element WidgetMarkup może zawierać tylko 1 z tych elementów. Możesz użyć wielu pól WidgetMarkup , aby wyświetlić więcej elementów.
data może być 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świetl klucz-wartość elementu w tym widżecie. |
Akapit tekstowy
Akapit z tekstem. Obsługiwany jest sformatowany tekst. Więcej informacji znajdziesz w sekcjach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.
Zapis JSON |
---|
{ "text": string } |
Pola | |
---|---|
text
|
|
Obraz
Obraz określony za pomocą adresu URL, który może wykonać działanie onclick
.
Zapis JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Pola | |
---|---|
imageUrl
|
Adres URL obrazu. |
onClick
|
Działanie |
aspectRatio
|
Format obrazu (szerokość i wysokość). To pole umożliwia zarezerwowanie odpowiedniej wysokości obrazu podczas oczekiwania na jego wczytanie. Nie powinno ono zastępować wbudowanego współczynnika proporcji obrazu. Jeśli zasada jest nieskonfigurowana, serwer wypełniający obraz, pobiera obraz z wyprzedzeniem. |
Po kliknięciu
Działanie onclick
(np. otwarcie linku).
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy:
|
|
action
|
Jeśli określisz działanie |
openLink
|
To działanie |
Czynność
Działanie formularza opisuje zachowanie podczas przesyłania 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 określa, która część formularza spowodowała przesłanie formularza. Informacje te są ponownie odczytywane w aplikacji Google Chat w ramach zdarzenia kliknięcia karty. Możesz użyć tej samej nazwy metody dla kilku elementów wyzwalających typowe zachowanie. |
parameters[]
|
Lista parametrów działania. |
Parametr działania
Lista parametrów ciągu znaków, które mają zostać podane po wywołaniu metody działania. Na przykład rozważ trzy drzemki: drzemka teraz, drzemka jeden dzień, drzemka w przyszłym tygodniu. Można użyć właściwości action method = snooze()
, przekazując 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, który chcesz otworzyć. |
Para klucz-wartość
Element interfejsu zawiera klucz (etykietę) 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 etykiety głównej. Obsługiwany jest sformatowany tekst. Więcej informacji znajdziesz w sekcjach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace. |
content
|
Tekst treści. Tekst sformatowany jest obsługiwany i zawsze wymagany. Więcej informacji znajdziesz w sekcjach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace. |
contentMultiline
|
Treść powinna być wielowierszowa. |
bottomLabel
|
Tekst dolnej etykiety. Obsługiwany jest sformatowany tekst. Więcej informacji znajdziesz w sekcjach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace. |
onClick
|
Działanie |
Pole sumy: icons . Musisz określić co najmniej jedną z ikon – top_label i bottom_label .
icons może być tylko jedną z tych wartości:
|
|
icon
|
Wartość wyliczeniowa, która jest zastąpiona przez Chat API interfejsem odpowiednim obrazem ikony. |
iconUrl
|
Ikona określona przez adres URL. |
Pole sumy: control . Widżet sterowania. Możesz ustawić button lub switch_widget , ale nie oba te elementy jednocześnie.
control może być tylko jedną z tych wartości:
|
|
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 obraz.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy:
|
|
textButton
|
Przycisk z tekstem i działaniem |
imageButton
|
Przycisk z obrazem i działaniem |
Przycisk tekstowy
Przycisk z tekstem i działaniem onclick
.
Zapis JSON |
---|
{
"text": string,
"onClick": {
object (
|
Pola | |
---|---|
text
|
Tekst na przycisku. |
onClick
|
Działanie |
Przycisk Obraz
Przycisk obrazu z działaniem onclick
.
Zapis JSON |
---|
{ "onClick": { object ( |
Pola | |
---|---|
onClick
|
Działanie |
name
|
Nazwa zasobu |
Pole sumy: icons . Ikonę można określić za pomocą Icon lub enum .
icons może być tylko jedną z tych wartości:
|
|
icon
|
Ikona określona przez |
iconUrl
|
Ikona określona przez adres URL. |
Działanie CardCard
Działanie karty to działanie powiązane z kartą. Typowym działaniem w przypadku karty faktury jest usunięcie faktury, wysłanie jej e-mailem lub otwarcie faktury w przeglądarce.
Nieobsługiwane przez aplikacje Google Chat.
Zapis JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
Pola | |
---|---|
actionLabel
|
Etykieta wyświetlana w menu czynności. |
onClick
|
Działanie „ onclick” w przypadku tego działania. |