Cards v1

Karta

Karta to element interfejsu, który może zawierać widżety takie jak tekst i obrazy.

Zapis JSON
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
Pola
header

object (CardHeader)

Nagłówek karty. Nagłówek zwykle zawiera tytuł i obraz.

sections[]

object (Section)

Sekcje są rozdzielone separatorami liniowymi.

cardActions[]

object (CardAction)

Działania dostępne na tej karcie.

name

string

Nazwa karty.

Nagłówek karty

Zapis JSON
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
Pola
title

string

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

string

Podtytuł nagłówka karty.

imageStyle

enum (ImageStyle)

Typ obrazu (na przykład obramowanie kwadratowe lub okrągłe).

imageUrl

string

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 (WidgetMarkup)
    }
  ]
}
Pola
header

string

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[]

object (WidgetMarkup)

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 (Button)
    }
  ],

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}
Pola
buttons[]

object (Button)

Lista przycisków. Przyciski też mają wartość oneof data i należy ustawić tylko jedno z tych pól.

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

object (TextParagraph)

Wyświetlaj akapit tekstu w tym widżecie.

image

object (Image)

Wyświetl obraz w tym widżecie.

keyValue

object (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

string

Obraz

Obraz określony za pomocą adresu URL, który może wykonać działanie onclick.

Zapis JSON
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
Pola
imageUrl

string

Adres URL obrazu.

onClick

object (OnClick)

Działanie onclick.

aspectRatio

number

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 data can be only one of the following:
  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
  // End of list of possible types for union field data.
}
Pola

Pole sumy: data.

data może być tylko jedną z tych wartości:

action

object (FormAction)

Jeśli określisz działanie onclick, zostanie ono aktywowane przez 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 (ActionParameter)
    }
  ]
}
Pola
actionMethodName

string

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[]

object (ActionParameter)

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

string

Nazwa parametru skryptu działania.

value

string

Wartość parametru.

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 (OnClick)
  },

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}
Pola
topLabel

string

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

string

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

boolean

Treść powinna być wielowierszowa.

bottomLabel

string

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

object (OnClick)

Działanie onclick. Klikać można tylko górną etykietę, etykietę dolną i region treści.

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

enum (Icon)

Wartość wyliczeniowa, która jest zastąpiona przez Chat API interfejsem odpowiednim obrazem ikony.

iconUrl

string

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

object (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 type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}
Pola

Pole sumy: type.

type może być tylko jedną z tych wartości:

textButton

object (TextButton)

Przycisk z tekstem i działaniem onclick.

imageButton

object (ImageButton)

Przycisk z obrazem i działaniem onclick.

Przycisk tekstowy

Przycisk z tekstem i działaniem onclick.

Zapis JSON
{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}
Pola
text

string

Tekst na przycisku.

onClick

object (OnClick)

Działanie onclick przycisku.

Przycisk Obraz

Przycisk obrazu z działaniem onclick.

Zapis JSON
{
  "onClick": {
    object (OnClick)
  },
  "name": string,

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}
Pola
onClick

object (OnClick)

Działanie onclick.

name

string

Nazwa zasobu imageButton, która jest używana na potrzeby ułatwień dostępu. Jeśli ta nazwa nie zostanie określona, podawana jest wartość domyślna.

Pole sumy: icons. Ikonę można określić za pomocą Icon lub enum. icons może być tylko jedną z tych wartości:
icon

enum (Icon)

Ikona określona przez enum, która wskazuje ikonę udostępnioną przez interfejs Chat API.

iconUrl

string

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 (OnClick)
  }
}
Pola
actionLabel

string

Etykieta wyświetlana w menu czynności.

onClick

object (OnClick)

Działanie „ onclick” w przypadku tego działania.