Cards v1

Karta

Karta to element interfejsu, który może zawierać widżety interfejsu, 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

Należy podać tytuł. Nagłówek ma stałą wysokość: jeśli podasz tytuł i podtytuł, każdy z nich zajmie jeden wiersz. 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 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, 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 też mają wartość oneof data i należy ustawić tylko jedno z tych pól.

Pole uniidata. Element 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świetlać 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 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)

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 zastępuje on wbudowanego formatu obrazu. Jeśli zasada jest nieskonfigurowana, serwer wypełnia ją, pobierając obraz z wyprzedzeniem.

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.

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

action

object (FormAction)

Działanie związane z formularzem jest wywoływane przez to działanie onclick, jeśli zostało określone.

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ą 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ą wspólne działanie.

parameters[]

object (ActionParameter)

Lista parametrów działań.

ActionParameter

Lista parametrów ciągu, które należy podać 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(), który przekazuje typ drzemki i czas drzemki na liście parametrów ciągu.

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ść). Element może też zawierać pewne działania, takie jak 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 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 do 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 mogą być tylko etykieta górna, dolna oraz region treści.

Pole sumy icons. Musisz zdefiniować co najmniej jedną z tych ikon:top_labeli bottom_label. icons może mieć 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ć button lub switch_widget, ale nie oba 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 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 mieć tylko jedną z tych wartości:

textButton

object (TextButton)

Przycisk z tekstem i onclickdziałaniem.

imageButton

object (ImageButton)

Przycisk z obrazem i działaniem onclick.

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 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 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. icons może mieć tylko jedną z tych wartości:
icon

enum (Icon)

Ikona wskazana przez obiekt enum wskazujący ikonę dostarczaną 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ł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.