Cards v1

Karta

Karta to element interfejsu, który może zawierać widżety interfejsu takie jak tekst czy 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 linią.

cardActions[]

object (CardAction)

Działania na tej karcie.

name

string

Nazwa karty.

CardHeader

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

string

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

string

Podtytuł nagłówka karty.

imageStyle

enum (ImageStyle)

Typ obrazu (np. kwadratowe lub okrągłe obramowanie).

imageUrl

string

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

string

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

object (WidgetMarkup)

Sekcja musi zawierać co najmniej jeden widżet.

WidgetMarkup

Widżet to element interfejsu, który prezentuje 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 są również oneof data i tylko jedno z nich powinno być ustawione.

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

object (TextParagraph)

Wyświetla akapit tekstu w tym widżecie.

image

object (Image)

Wyświetlaj obraz w tym widżecie.

keyValue

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

string

Obraz

Obraz określony za pomocą adresu URL i może mieć atrybut onclick działania.

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

string

Adres URL obrazu.

onClick

object (OnClick)

onclick działania.

aspectRatio

number

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 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 jednym z tych elementów:

action

object (FormAction)

Działanie formularza jest wywoływane przez onclick czynność, jeśli jest określona.

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 (ActionParameter)
    }
  ]
}
Pola
actionMethodName

string

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

object (ActionParameter)

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

string

Nazwa parametru skryptu działania.

value

string

Wartość parametru.

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

string

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

boolean

Czy treść powinna być wielowierszowa.

bottomLabel

string

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

object (OnClick)

onclick działania. Klikalne mogą być tylko etykieta górna, dolna oraz region treści.

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

enum (Icon)

Wartość wyliczeniowa, którą zastępuje Chat API odpowiednim obrazem ikony.

iconUrl

string

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

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 graficzny.

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 jednym z tych elementów:

textButton

object (TextButton)

Przycisk z tekstem onclick działania.

imageButton

object (ImageButton)

Przycisk z obrazem onclick działania.

TextButton

Przycisk z tekstem onclick działania.

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

string

Tekst na przycisku.

onClick

object (OnClick)

onclick przez naciśnięcie przycisku.

ImageButton

Przycisk graficzny ze znakiem onclick działania.

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)

onclick działania.

name

string

Nazwa elementu imageButton który jest wykorzystywany w przypadku ułatwień dostępu. Jeśli nie podasz tej nazwy, zostanie podana wartość domyślna.

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

enum (Icon)

Ikona wskazana przez tag enum które wskazuje ikonę dostarczaną przez interfejs Chat API.

iconUrl

string

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

string

Etykieta, która była wyświetlana w menu czynności.

onClick

object (OnClick)

Działanie „onclick” dla tego działania.