Cards v1

Karta

Karta to element interfejsu użytkownika, który może zawierać widżety interfejsu użytkownika, 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ą rozdzielane linią.

cardActions[]

object (CardAction)

Czynności związane z tą kartą.

name

string

Nazwa karty.

CardHeader

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

string

Musisz podać tytuł. Nagłówek ma stałą wysokość: jeśli określony jest zarówno tytuł, jak i podtytuł, każdy z nich zajmuje jeden wiersz. Jeśli podany jest tylko tytuł, zajmuje on obie linie.

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 Okrągłe obramowanie.

Sekcja

Sekcja zawiera zbiór widżetów, które są renderowane (pionowo) w kolejności, w jakiej zostały określone. Na wszystkich platformach karty mają wąską stałą szerokość, więc obecnie nie ma potrzeby stosowania właściwości układu (np. float).

Zapis JSON 
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
Pola
header

string

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 Google Workspace.

widgets[]

object (WidgetMarkup)

Sekcja musi zawierać co najmniej 1 widżet.

WidgetMarkup

Widżet to element interfejsu użytkownika, który zawiera 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. Pola przyciskówoneof datamożna ustawić tylko jedno.

Pole unii data. WidgetMarkup może zawierać tylko jeden z tych elementów: Aby wyświetlić więcej elementów, możesz użyć wielu pól WidgetMarkup. datamoże być tylko jedną z tych wartości:
textParagraph

object (TextParagraph)

Wyświetlanie akapitu tekstu w tym widżecie.

image

object (Image)

Wyświetlanie obrazu w tym widżecie.

keyValue

object (KeyValue)

Wyświetla w tym widżecie element klucz-wartość.

TextParagraph

akapit tekstu, Obsługiwany jest tekst sformatowany. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach Google Workspace.

Zapis JSON 
{
  "text": string
}
Pola
text

string

Obraz

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

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

string

Adres URL obrazu.

onClick

object (OnClick)

Czynnośćonclick.

aspectRatio

number

Współczynnik proporcji tego obrazu (szerokość i wysokość). To pole umożliwia zarezerwowanie odpowiedniej wysokości dla obrazu podczas oczekiwania na jego załadowanie. Nie ma on na celu zastąpienia wbudowanego współczynnika proporcji obrazu. Jeśli nie jest ustawiony, serwer wypełnia go, pobierając obraz z pamięci podręcznej.

OnClick

onclickdział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 unii data.

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

action

object (FormAction)

Jeśli to pole jest wypełnione, działanie onclick powoduje wykonanie działania formularza.

FormAction

Działanie formularza określa, co się dzieje po jego przesłaniu. 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 identyfikowania, która część formularza spowodowała jego przesłanie. Te informacje są odsyłane do aplikacji Google Chat w ramach zdarzenia kliknięcia karty. Możesz używać tej samej nazwy metody w przypadku kilku elementów, które wywołują podobne działanie.

parameters[]

object (ActionParameter)

Lista parametrów działania.

ActionParameter

Lista parametrów ciągu znaków do podania podczas wywołania metody działania. Weźmy na przykład 3 przyciski drzemki: drzemka teraz, drzemka za 1 dzień, drzemka w przyszłym tygodniu. Możesz użyć parametru action method = snooze(), przekazując typ 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 użytkownika zawiera klucz (etykieta) i wartość (treść). Element ten może też zawierać działania, takie jak przyciskonclick.

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 górnej etykiety. Obsługiwany jest tekst sformatowany. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach Google Workspace.

content

string

Tekst treści. Formatowany 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 Google Workspace.

contentMultiline

boolean

czy treść powinna być wielowierszowa;

bottomLabel

string

Tekst dolnej etykiety. Obsługiwany jest tekst sformatowany. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach Google Workspace.

onClick

object (OnClick)

Czynnośćonclick. Klikalne są tylko górna i dolna etykieta oraz obszar treści.

Pole uniiicons. Musisz zdefiniować co najmniej jedną z tych właściwości: top_label, bottom_label. iconsmoże być tylko jedną z tych wartości:
icon

enum (Icon)

Wartość typu enum, która jest zastępowana przez interfejs API Google Chat odpowiednią ikoną.

iconUrl

string

Ikona określona za pomocą adresu URL.

Pole uniicontrol. Widżet sterujący. Możesz ustawić wartość button lub switch_widget, ale nie obie jednocześnie. controlmoż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 przycisk z obrazem.

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 unii type.

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

textButton

object (TextButton)

Przycisk z tekstem i onclickdziałaniem.

imageButton

object (ImageButton)

Przycisk z obrazem i onclickdziałaniem.

TextButton

Przycisk z tekstem i onclickdziałaniem.

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

string

Tekst na przycisku.

onClick

object (OnClick)

onclickdziałanie przycisku.

ImageButton

Przycisk graficzny z działaniemonclick

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)

Czynnośćonclick.

name

string

Nazwa tego imageButton, który jest używany w ułatwieniach dostępu. Jeśli nie podasz tej nazwy, zostanie podana wartość domyślna.

Pole uniiicons. Ikona może być określona za pomocą parametru Icon lub enum albo adresu URL. iconsmoże być tylko jedną z tych wartości:
icon

enum (Icon)

Ikona określona przez parametr enum, który indeksuje ikonę udostępnioną przez interfejs Chat API.

iconUrl

string

Ikona określona za pomocą adresu URL.

CardAction

Działanie na karcie to działanie powiązane z kartą. W przypadku karty faktury typowe działania to: usuwanie faktury, wysyłanie faktury e-mailem lub otwieranie 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 dla tego elementu działania.