Cards v1

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Karta

Karta to element interfejsu, który może zawierać widżety interfejsu takie jak tekst, 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ę podziału.

cardActions[]

object ( CardAction )

Działania tej karty.

name

string

Nazwa karty.

KartaNagłówek

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

string

Musisz podać tytuł. Nagłówek ma stałą wysokość. Jeśli podajesz zarówno tytuł, jak i podtytuł, każdy z nich będzie zajmować 1 wiersz. Jeśli określony jest tylko tytuł, będzie on używany w obu wierszach.

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.

Styl obrazu

Wartości w polu enum
IMAGE_STYLE_UNSPECIFIED
IMAGE Obramowanie kwadratowe.
AVATAR Obramowanie kołowe.

Sekcja

Sekcja zawiera zbiór widżetów renderowanych (pionowo) w określonej kolejności. Na wszystkich platformach karty mają wąską szerokość, więc obecnie nie trzeba zmieniać właściwości układu (np. liczby zmiennoprzecinkowej).

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

string

Nagłówek sekcji z obsługiwanym tekstem.

widgets[]

object ( WidgetMarkup )

Sekcja musi zawierać co najmniej 1 widżet.

Znacznik widżetu

Widżet to element interfejsu, który wyświetla tekst, obrazy itp.

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 również mogą służyć do danych i należy ustawić tylko jedno z tych pól.

Pole sumy data . Element WidgetMarkup może mieć tylko jeden z tych elementów. Aby wyświetlić więcej elementów, możesz użyć wielu pól WidgetMarkup. data może mieć 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świetlaj element pary klucz-wartość w tym widżecie.

Akapit tekstowy

Akapit z tekstem. Formatowanie jest obsługiwane.

Zapis JSON
{
  "text": string
}
Pola
text

string

Obraz

Obraz określony za pomocą adresu URL, który może zawierać 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

Współczynnik proporcji tego obrazu (szerokość/wysokość). To pole umożliwia klientom zarezerwowanie odpowiedniej wysokości dla obrazu podczas oczekiwania na jego załadowanie. Nie zastępują one natywnego współczynnika proporcji obrazu. Jeśli jej nie skonfigurujesz, serwer napełni ją, wstępnie pobierając obraz.

OnClick

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 mieć tylko jedną z tych wartości:

action

object ( FormAction )

Jeśli określisz, aktywuje to działanie formularza.

Czynność

Działanie formularza opisuje zachowanie po przesłaniu formularza. Na przykład można wywołać skrypt 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 przesłanie formularza. Informacje te są odczytywane z powrotem do aplikacji Google Chat w ramach zdarzenia kliknięcia karty. Tej samej nazwy metody można użyć w przypadku kilku elementów, które w razie potrzeby mogą uruchamiać często używane zachowanie.

parameters[]

object ( ActionParameter )

Lista parametrów działań.

Parametr działania

Lista parametrów ciągu znaków do podania podczas wywoływania metody działania. Weźmy na przykład 3 przyciski drzemki: drzemka teraz, drzemka 1 dzień, drzemka w przyszłym tygodniu. Możesz użyć metody działania = drzemka(), która 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łań.

value

string

Wartość parametru.

Para klucz-wartość

Element interfejsu zawiera klucz (etykietę) i wartość (treść). Poza tym ten element może też zawierać niektóre czynności, 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. Formatowanie jest obsługiwane.

content

string

Tekst treści. Sformatowany tekst jest obsługiwany i zawsze wymagany.

contentMultiline

boolean

Treść powinna być wielowierszowa.

bottomLabel

string

Tekst dolnej etykiety. Formatowanie jest obsługiwane.

onClick

object ( OnClick )

Działanie „onclick”. Można kliknąć tylko etykietę górną, dolną i region treści.

Pole sumy icons . Musisz określić co najmniej jedną z tych ikon: górna i dolna etykieta. icons może mieć tylko jedną z tych wartości:
icon

enum ( Icon )

Wartość wyliczenia, która zostanie zastąpiona przez Chat Chat odpowiednim obrazem ikony.

iconUrl

string

Ikona określona przez adres URL.

Pole sumy control . Widżet sterujący. Można ustawić przycisk lub Switch_Widget, ale nie oba te elementy. control może mieć 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 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 tego przycisku graficznego, który będzie używany na potrzeby ułatwień dostępu. Jeśli deweloperzy tego nie określą, zostanie podana wartość domyślna.

Pole sumy icons . Ikona może być określona przez wyliczenie ikony lub adres URL. icons może mieć tylko jedną z tych wartości:
icon

enum ( Icon )

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

iconUrl

string

Ikona określona przez adres URL.

Działanie karty

Działanie karty to działanie powiązane z kartą. W przypadku karty faktury typowym działaniem jest usunięcie faktury lub e-maila z fakturą albo otwarcie faktury w przeglądarce.

Nieobsługiwane przez aplikacje Google Chat.

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

string

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

onClick

object ( OnClick )

Działanie „onclick” tego działania.