Cards v2

{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string,
  "fixedFooter": {
    object (CardFixedFooter)
  },
  "displayStyle": enum (DisplayStyle),
  "peekCardHeader": {
    object (CardHeader)
  }
}

object (CardHeader)

Nagłówek karty. Nagłówek zwykle zawiera obraz na początku i tytuł. Nagłówki zawsze wyświetlają się u góry karty.

object (Section)

Zawiera kolekcję widżetów. Każda sekcja ma własny, opcjonalny nagłówek. Sekcje są wizualnie rozdzielone przecinkami.

object (CardAction)

Działania na karcie. Czynności są dodawane do menu paska narzędzi karty.

Karty aplikacji Google Chat nie mają paska narzędzi, dlatego cardActions[] nie jest obsługiwany w aplikacjach Google Chat.

Na przykład poniższy kod JSON tworzy menu działania karty z opcjami Settings i Send Feedback:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]

string

Nazwa karty. Używane jako identyfikator karty w Nawigacji po karcie.

Aplikacje do obsługi czatu nie obsługują nawigacji na kartach, dlatego to pole jest ignorowane.

object (CardFixedFooter)

Stała stopka widoczna na dole tej karty.

Ustawienie fixedFooter bez określenia primaryButton lub secondaryButton powoduje błąd.

Obsługiwane przez dodatki do Google Workspace i aplikacje do obsługi czatu. W przypadku aplikacji do obsługi czatu możesz używać stałych stopek w oknach, ale nie w wiadomościach na kartach.

enum (DisplayStyle)

W dodatkach do Google Workspace ustawia właściwości wyświetlania elementu peekCardHeader.

Nieobsługiwane przez aplikacje do obsługi czatu.

object (CardHeader)

Gdy wyświetlasz treści kontekstowe, nagłówek karty podglądu jest narzędziem zastępczym, dzięki któremu użytkownik może przechodzić między kartami na stronie głównej i kontekstami kontekstowymi.

Nieobsługiwane przez aplikacje do obsługi czatu.

{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}

string

Wymagany. Tytuł nagłówka karty. 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.

string

Podtytuł nagłówka karty. Jeśli jest określony, znajduje się w osobnym wierszu poniżej title.

enum (ImageType)

Kształt używany do przycinania.

string

Adres URL HTTPS obrazu w nagłówku karty.

string

Tekst zastępczy obrazu, który jest używany przy ułatwieniach dostępu.

{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer
}

string

Tekst wyświetlany u góry sekcji. Obsługuje prosty tekst w formacie HTML. Więcej informacji znajdziesz w sekcjach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.

object (Widget)

Wszystkie widżety w sekcji. Musi zawierać co najmniej jeden widżet.

boolean

Wskazuje, czy ta sekcja jest zwijana.

Sekcje zwijane ukrywają niektóre lub wszystkie widżety, ale użytkownicy mogą je rozwinąć, klikając Pokaż więcej. Użytkownicy mogą ponownie ukrywać widżety, klikając Pokaż mniej.

Aby określić, które widżety są ukryte, podaj uncollapsibleWidgetsCount.

integer

Liczba zwijanych widżetów, które są widoczne nawet po zwinięciu sekcji.

Jeśli na przykład sekcja zawiera 5 widżetów, a atrybut uncollapsibleWidgetsCount ma wartość 2, pierwsze 2 widżety są zawsze wyświetlane, a 3 ostatnie są domyślnie zwinięte. Pole uncollapsibleWidgetsCount jest uwzględniane tylko wtedy, gdy collapsible ma wartość true.

{
  "horizontalAlignment": enum (HorizontalAlignment),

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "divider": {
    object (Divider)
  },
  "grid": {
    object (Grid)
  },
  "columns": {
    object (Columns)
  }
  // End of list of possible types for union field data.
}

enum (HorizontalAlignment)

Określa, czy widżety mają być wyrównane do lewej, prawej czy do środka kolumny.

object (TextParagraph)

Wyświetla akapit. Obsługuje prosty tekst w formacie HTML. Więcej informacji znajdziesz w sekcjach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.

W poniższym pliku JSON pogrubiony zostanie tekst:

"textParagraph": {
  "text": "  <b>bold text</b>"
}

object (Image)

Wyświetla obraz.

Na przykład ten JSON tworzy obraz z tekstem alternatywnym:

"image": {
  "imageUrl":
  "https://developers.google.com/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}

object (DecoratedText)

Wyświetla ozdobny element tekstowy.

Ten przykładowy kod JSON tworzy na przykład ozdobny widżet tekstowy z adresem e-mail:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

object (ButtonList)

Lista przycisków.

Na przykład poniższy kod JSON tworzy 2 przyciski. Pierwszy to niebieski przycisk tekstowy, a drugi obraz – przycisk, który otwiera link.

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
        "alpha": 1
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

object (TextInput)

Wyświetla pole tekstowe, w którym użytkownicy mogą pisać.

Na przykład następujący kod JSON tworzy pole tekstowe do adresu e-mail:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

W tym przykładzie ten kod JSON tworzy tekst w języku programowania z podpowiedziami statycznymi:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

object (SelectionInput)

Wyświetla element wyboru, który pozwala użytkownikom wybierać elementy. Elementami sterującymi mogą być pola wyboru, przyciski, przełączniki i menu.

Ten przykładowy plik JSON tworzy menu pozwalające użytkownikom wybrać rozmiar:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}

object (DateTimePicker)

Wyświetla widżet, który umożliwia wpisywanie daty, godziny lub daty i godziny.

Na przykład ten JSON tworzy selektor daty i godziny, aby zaplanować spotkanie:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": "796435200000"
}

object (Divider)

Wyświetla poziomą linię pomiędzy widżetami.

Separatorem może być np. następujący kod JSON:

"divider": {
}

object (Grid)

Wyświetla siatkę z elementami.

Siatka obsługuje dowolną liczbę kolumn i elementów. Liczba wierszy zależy od górnej granicy liczby elementów podzielonej przez liczbę kolumn. Siatka z 10 elementami i 2 kolumnami ma 5 wierszy. Siatka zawiera 11 elementów i 2 kolumny, w 6 wierszy.

Na przykład poniższy kod JSON tworzy 2-kolumnową siatkę z jednym elementem:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

object (Columns)

Wyświetla do 2 kolumn.

Aby uwzględnić więcej niż 2 kolumny lub użyć wierszy, użyj widżetu Grid.

Na przykład poniższy kod JSON tworzy 2 kolumny, z których każda zawiera akapit:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}

{
  "text": string
}

string

Tekst widoczny w widżecie.

{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "altText": string
}

string

Adres URL HTTPS, który hostuje obraz.

Na przykład:

https://developers.google.com/chat/images/quickstart-app-avatar.png

object (OnClick)

To kliknięcie wywołuje to zdarzenie, gdy użytkownik klika obraz.

string

Tekst zastępczy obrazu, który jest używany przy ułatwieniach dostępu.

{

  // Union field data can be only one of the following:
  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  }
  // End of list of possible types for union field data.
}

object (Action)

Jeśli zasada jest określona, działanie jest wywoływane przez to zdarzenie onClick.

object (OpenLink)

Jeśli zasada jest określona, onClick uruchamia działanie otwartego linku.

object (Action)

Dodatek uruchamia to działanie, gdy musi otworzyć link. Różni się to od powyższego openLink, ponieważ w celu uzyskania linku do komunikacji z serwerem wymagana jest ta komunikacja. W związku z tym klient internetowy musi wykonać pewne czynności przygotowawcze, zanim pojawi się odpowiedź na żądanie „otwarty link”.

object (Card)

Nowa karta jest przesyłana do stosu kart po kliknięciu, jeśli został określony.

Obsługiwana przez dodatki do Google Workspace, ale nie przez aplikacje Google Chat.

{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}

string

Funkcja niestandardowa, która ma być wywoływana po kliknięciu lub aktywowaniu elementu zawierającego.

Więcej informacji znajdziesz w artykule Tworzenie interaktywnych kart.

object (ActionParameter)

Lista parametrów działania.

enum (LoadIndicator)

Określa wskaźnik wczytywania wyświetlany podczas wykonywania działania.

boolean

Wskazuje, czy po formularzu działanie formularza pozostaje aktywne. Wartością domyślną jest false.

Jeśli pole true zawiera wartości, po wypełnieniu pola działanie pozostaje aktywne. Aby pozwolić użytkownikowi na wprowadzanie zmian podczas przetwarzania działania, ustaw LoadIndicator na NONE. W przypadku kart kart w aplikacjach Google Chat musisz też ustawić wartość ResponseType dla działania na UPDATE_MESSAGE i użyć tej samej wartości cardId z karty, która zawiera działanie.

Jeśli false, wartości formularza zostaną wyczyszczone po wywołaniu działania. Aby uniemożliwić użytkownikowi wprowadzanie zmian podczas przetwarzania działania, ustaw wartość LoadIndicator na SPINNER.

enum (Interaction)

Opcjonalnie. Wymagane przy otwieraniu okna.

Co zrobić w odpowiedzi na interakcję użytkownika, np. kliknięcie przycisku w wiadomości na karcie.

Jeśli nie określono inaczej, aplikacja reaguje w zwykły sposób, uruchamiając action, np. otwierając link lub uruchamiając funkcję.

Jeśli określisz interaction, aplikacja może reagować w specjalny sposób. Jeśli na przykład ustawisz interaction na wartość OPEN_DIALOG, aplikacja będzie mogła otwierać okno. Jeśli podasz wartość, wskaźnik ładowania się nie wyświetli.

Obsługiwane przez aplikacje do obsługi czatu, ale nie w ramach dodatków do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.

{
  "key": string,
  "value": string
}

string

Nazwa parametru skryptu działania.

string

Wartość parametru.

{
  "url": string,
  "openAs": enum (OpenAs),
  "onClose": enum (OnClose)
}

string

Adres URL, który chcesz otworzyć.

enum (OpenAs)

Jak otworzyć link Nieobsługiwane przez aplikacje do obsługi czatu.

enum (OnClose)

Określa, czy klient zapomni o linku po jego otwarciu czy obserwuje go do momentu zamknięcia okna. Nieobsługiwane przez aplikacje do obsługi czatu.

{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "topLabel": string,
  "text": string,
  "wrapText": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
  // End of list of possible types for union field control.
}

object (Icon)

Wycofano na rzecz startIcon.

object (Icon)

Ikona wyświetlana przed tekstem.

string

Tekst wyświetlany nad tekstem text. Zawsze skracaj.

string

Wymagany. Tekst główny.

Obsługuje proste formatowanie. Więcej informacji znajdziesz w sekcjach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.

boolean

Ustawienie zawijania tekstu. Jeśli true, tekst zostanie zawijany i wyświetlany w kilku wierszach. W przeciwnym razie tekst zostanie skrócony.

Dotyczy tylko: text, a nie topLabel i bottomLabel.

string

Tekst widoczny poniżej: text. Zawsze się zamyka.

object (OnClick)

To działanie jest wywoływane, gdy użytkownicy klikną topLabel lub bottomLabel.

object (Button)

Przycisk, który użytkownik może kliknąć, aby wywołać działanie.

object (SwitchControl)

Widżet przełączania, który użytkownik może kliknąć, aby zmienić stan i aktywować działanie

object (Icon)

Ikona wyświetlana po tekście.

Obsługuje ikony wbudowane i niestandardowe.

{
  "altText": string,
  "imageType": enum (ImageType),

  // Union field icons can be only one of the following:
  "knownIcon": string,
  "iconUrl": string
  // End of list of possible types for union field icons.
}

string

Opcjonalnie. Opis ikony ułatwień dostępu. Jeśli wartość nie jest określona, podawana jest wartość domyślna Button. Dobrze jest utworzyć przydatny opis tego, co wyświetla się ikona (w razie potrzeby). na przykład A user's account portrait lub Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat.

Jeśli ikonę jest ustawiona w Button, altText pojawi się jako tekst pomocniczy, gdy użytkownik najedzie na przycisk. Jeśli jednak przycisk ustawia też typ text, wartość altText jest ignorowana.

enum (ImageType)

Styl przycinania zastosowany do obrazu. W niektórych przypadkach zastosowanie przycięcia w formacie CIRCLE powoduje, że obraz jest pobierany jako większy niż wbudowana ikona.

string

Wyświetlaj jedną z wbudowanych ikon Google Workspace.

Aby na przykład wyświetlić ikonę samolotu, podaj AIRPLANE. W przypadku autobusu określ BUS.

Pełną listę obsługiwanych ikon znajdziesz w sekcji Ikony wbudowane.

string

Wyświetlaj ikonę niestandardową hostowaną pod adresem URL HTTPS.

Na przykład:

"iconUrl":
"https://developers.google.com/chat/images/quickstart-app-avatar.png"

Obsługiwane typy plików to .png i .jpg.

{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string
}

string

Tekst wyświetlany na przycisku.

object (Icon)

Obraz ikony. Jeśli ustawione są icon i text, przed tekstem pojawia się ikona.

object (Color)

Po ustawieniu przycisk jest wypełniany jednolitym kolorem tła, a kolor czcionki zmienia się, aby zachować kontrast z kolorem tła. Na przykład ustawienie niebieskiego tła powoduje, że pojawia się biały tekst.

Jeśli zasada jest nieskonfigurowana, tło obrazu jest białe, a czcionka ma kolor niebieski.

W przypadku czerwonych, zielonych i niebieskich wartości każdego pola można podać float wartość, którą możesz wyrazić na 2 sposoby: jako liczbę z zakresu od 0 do 255 podzieloną przez 255 (153/255) lub jako wartość od 0 do 1 (0,6). 0 oznacza brak koloru i 1 lub 255/255 oznacza pełną obecność tego koloru w skali RGB.

Opcjonalnie ustaw alpha, aby ustawić poziom przezroczystości za pomocą tego równania:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

W przypadku alpha wartość 1 odpowiada jednolitemu kolorowi, wartość 0 odpowiada całkowicie przezroczystemu kolorowi.

Na przykład ten kolor to półprzezroczysty czerwony:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
   "alpha": 0.5
}

object (OnClick)

Wymagany. Działanie wykonywane, gdy użytkownik kliknie przycisk – na przykład otworzy hiperlink lub uruchomi funkcję niestandardową.

boolean

Jeśli true jest wyświetlany, przycisk jest nieaktywny i nie reaguje na działania użytkownika.

string

Tekst alternatywny używany przy ułatwieniach dostępu.

Ustaw tekst opisowy informujący użytkowników o przeznaczeniu przycisku. Jeśli na przykład przycisk uruchamia hiperlink, możesz napisać: „Otwiera nową kartę przeglądarki i otwiera dokumentację dla deweloperów Google Chat na stronie https://developers.google.com/chat”.

{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}

number

Czerwony kolor w postaci wartości z przedziału [0, 1].

number

Zielony kolor w wartościach z przedziału [0, 1].

number

Niebieski kolor w wartościach z przedziału [0, 1].

number

Odsetek tego koloru, który należy zastosować w pikselu. Oznacza to, że końcowy kolor piksela jest określany za pomocą równania:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Oznacza to, że wartość 1,0 odpowiada jednolitemu kolorowi, a wartość 0,0 odpowiada całkowicie przezroczystemu kolorowi. Korzysta on z kodu towarzyszącego, a nie z prostego skalarnego skalarnego, dzięki czemu można odróżnić wartość domyślną od ustawionej. Jeśli ten warunek zostanie pominięty, obiekt koloru jest renderowany jako jednolity kolor (tak jakby wartość alfa wynosiła 1,0).

{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}

string

Nazwa, za pomocą której definiuje się widżet przełączania w zdarzeniu wprowadzania danych z formularza.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

string

Wartość wpisana przez użytkownika, zwracana w ramach zdarzenia wejściowego formularza.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

boolean

Gdy zasada true jest włączona, przełącznik jest wybierany.

object (Action)

Działanie, które ma być wykonywane po zmianie stanu zmiany, np. jakie funkcje mają być wykonywane.

enum (ControlType)

Wygląd przełącznika w interfejsie.

{
  "buttons": [
    {
      object (Button)
    }
  ]
}

object (Button)

Tablica przycisków.

{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  }
}

string

Nazwa określająca dane wejściowe w zdarzeniu wprowadzania danych z formularza.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

string

Tekst wyświetlany nad polem wprowadzania tekstu w interfejsie.

Podaj tekst, który pomoże użytkownikowi wpisać informacje, których potrzebuje Twoja aplikacja. Jeśli na przykład prosisz kogoś o imię, ale potrzebujesz imienia, wpisz surname zamiast name.

Wymagany, jeśli właściwość hintText nie jest określona. W przeciwnym razie (opcjonalnie).

string

Tekst wyświetlany pod polem wprowadzania tekstu, który ma zachęcić użytkowników do wpisania określonej wartości. Ten tekst jest zawsze widoczny.

Wymagany, jeśli właściwość label nie jest określona. W przeciwnym razie (opcjonalnie).

string

Wartość wpisana przez użytkownika, zwracana w ramach zdarzenia wejściowego formularza.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

enum (Type)

Sposób, w jaki w interfejsie wyświetlane jest pole do wprowadzania tekstu. np. czy pole jest jednowierszowe czy wielowierszowe.

object (Action)

Co zrobić, gdy w polu tekstowym pojawi się zmiana. Na przykład użytkownik dodający do pola lub usuwając tekst.

Przykładowe działania to uruchomienie własnej funkcji lub otwarcie okna w Google Chat.

object (Suggestions)

Sugerowane wartości, które użytkownicy mogą wpisać. Te wartości pojawiają się, gdy użytkownicy klikają pole do wprowadzania tekstu. Gdy użytkownicy piszą, sugerowane wartości są dynamicznie filtrowane zgodnie z wpisanym tekstem.

Na przykład pole do wprowadzania tekstu w języku programowania może proponować język Java, JavaScript, Python i C++. Gdy użytkownicy zaczną wpisywać Jav, na liście sugestii pojawią się filtry Java i JavaScript.

Sugerowane wartości pomagają użytkownikom wpisywać wartości, które mogą być przydatne w aplikacji. Gdy odwołujemy się do JavaScriptu, niektórzy użytkownicy mogą wpisać javascript, a inne java script. Sugerowanie właściwości JavaScript może ujednolicić sposób interakcji użytkowników z aplikacją.

Jeśli zasada jest określona, właściwość TextInput.type ma zawsze wartość SINGLE_LINE, nawet jeśli jest ustawiona na MULTIPLE_LINE.

object (Action)

Opcjonalnie. Określ, jakie działania mają być wykonywane, gdy pole do wprowadzania tekstu zawiera sugestie dla użytkowników, którzy z niego korzystają.

Jeśli nie określono inaczej, sugestie są ustawiane przez zasadę initialSuggestions i są przetwarzane przez klienta.

Jeśli zasada jest skonfigurowana, aplikacja wykonuje opisane tu działanie, takie jak uruchamianie funkcji niestandardowej.

Obsługiwana przez dodatki do Google Workspace, ale nie przez aplikacje Google Chat.

{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}

object (SuggestionItem)

Lista sugestii używanych do autouzupełniania rekomendacji w polach wprowadzania tekstu.

{

  // Union field content can be only one of the following:
  "text": string
  // End of list of possible types for union field content.
}

string

Wartość sugerowanego pola wprowadzania tekstu. Jest to odpowiednik tekstu wpisanego przez użytkownika.

{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  }
}

string

Nazwa określająca dane wejściowe wybrane w zdarzeniu wprowadzania danych z formularza.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

string

Tekst wyświetlany nad polem wyboru w interfejsie.

Podaj tekst, który pomoże użytkownikowi wpisać informacje, których potrzebuje Twoja aplikacja. Jeśli na przykład użytkownicy wybierają z menu opcję pilnego biletu do pracy, może ona mieć etykietę „Pilne” lub „Wybierz pilne”.

enum (SelectionType)

Typ elementów wyświetlanych użytkownikom w widżecie SelectionInput. Typy wyboru obsługują różne typy interakcji. Na przykład użytkownicy mogą zaznaczać co najmniej jedno pole wyboru, ale z menu mogą wybrać tylko jedną wartość.

object (SelectionItem)

Tablica elementów do wyboru. Przykładem może być tablica opcji lub pól wyboru. Obsługuje do 100 elementów.

object (Action)

Jeśli wybierzesz ten warunek, formularz zostanie przesłany po zmianie wyboru. Jeśli nie podasz odpowiedzi, musisz określić osobny przycisk, który przesyła formularz.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

{
  "text": string,
  "value": string,
  "selected": boolean
}

string

Tekst określający lub opisujący produkt użytkownikom.

string

Wartość powiązana z tym elementem. Klient powinien używać go jako wartości wejściowej formularza.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

boolean

Jeśli wybrano element true, wybierany jest więcej niż 1 element. Jeśli wybierzesz więcej niż jeden element dla opcji i menu rozwijanego, pierwszy wybrany element zostanie odebrany, a pozostałe zostaną zignorowane.

{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}

string

Nazwa, za pomocą której określony jest element DateTimePicker w zdarzeniu danych wejściowych w formularzu.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

string

Tekst zachęcający użytkowników do wpisania daty, godziny lub daty i godziny. Jeśli na przykład użytkownicy planują spotkanie, użyj etykiety takiej jak Appointment date lub Appointment date and time.

enum (DateTimePickerType)

Określa, czy widżet obsługuje wprowadzanie daty, godziny lub daty i godziny.

string (int64 format)

Wartość domyślna wyświetlana w widżecie w milisekundach od czasu uniksowego.

Określ wartość w zależności od typu selektora (DateTimePickerType):

• DATE_AND_TIME: data i godzina w kalendarzu w strefie czasowej UTC. Na przykład aby podać datę 1 stycznia 2023 r., godz. 12:00 UTC, użyj 1672574400000.
• DATE_ONLY: data w kalendarzu o godzinie 00:00:00 czasu UTC. Na przykład do 1 stycznia 2023 r. użyj wartości 1672531200000.
• TIME_ONLY: czas w strefie czasowej UTC. Na przykład, aby uwzględnić godzinę 12:00, wpisz 43200000 (lub 12 * 60 * 60 * 1000).

integer

Liczba określająca przesunięcie czasu względem strefy czasowej UTC w minutach. Jeśli zasada jest ustawiona, wartość valueMsEpoch jest wyświetlana w określonej strefie czasowej. Jeśli zasada jest nieskonfigurowana, wartością domyślną jest ustawienie strefy czasowej użytkownika.

object (Action)

Wywoływane, gdy użytkownik kliknie Zapisz lub Wyczyść w interfejsie DateTimePicker.

{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}

string

Tekst wyświetlany w nagłówku siatki.

object (GridItem)

Elementy do wyświetlenia w siatce.

object (BorderStyle)

Styl obramowania, który zostanie zastosowany do każdego elementu siatki.

integer

Liczba kolumn wyświetlanych w siatce. Jeśli nie określisz wartości tego pola, będzie używana wartość domyślna, która różni się w zależności od tego, gdzie wyświetla się siatka (dialog i element towarzyszący).

object (OnClick)

To wywołanie zwrotne jest używane przez każdy element siatki, ale z identyfikatorem i indeksem elementu na liście elementów dodanej do parametrów wywołania zwrotnego.

{
  "id": string,
  "image": {
    object (ImageComponent)
  },
  "title": string,
  "subtitle": string,
  "layout": enum (GridItemLayout)
}

string

Identyfikator użytkownika określony przez użytkownika dla tego elementu siatki. Ten identyfikator jest zwracany w parametrach wywołania onClick siatki nadrzędnej.

object (ImageComponent)

Obraz wyświetlany w elemencie siatki.

string

Tytuł elementu siatki.

string

Podtytuł elementu siatki.

enum (GridItemLayout)

Układ, który ma być używany na potrzeby elementu siatki.

{
  "imageUri": string,
  "altText": string,
  "cropStyle": {
    object (ImageCropStyle)
  },
  "borderStyle": {
    object (BorderStyle)
  }
}

string

Adres URL obrazu.

string

Etykieta ułatwień dostępu obrazu.

object (ImageCropStyle)

Styl przycinania, który ma zostać zastosowany do obrazu.

object (BorderStyle)

Styl obramowania, który zostanie zastosowany do obrazu.

{
  "type": enum (ImageCropType),
  "aspectRatio": number
}

enum (ImageCropType)

Typ przycięcia.

number

Współczynnik proporcji używany, jeśli typ przycięcia to RECTANGLE_CUSTOM.

Aby na przykład zastosować współczynnik proporcji 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}

enum (BorderType)

Typ obramowania.

object (Color)

Kolory używane, gdy typ to BORDER_TYPE_STROKE.

integer

Promień narożnika obramowania.

{
  "columnItems": [
    {
      object (Column)
    }
  ]
}

object (Column)

Tablica kolumn. Na karcie lub w oknie dialogowym możesz umieścić maksymalnie 2 kolumny.

{
  "horizontalSizeStyle": enum (HorizontalSizeStyle),
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "widgets": [
    {
      object (Widgets)
    }
  ]
}

enum (HorizontalSizeStyle)

Określa, jak kolumna wypełnia szerokość karty.

enum (HorizontalAlignment)

Określa, czy widżety mają być wyrównane do lewej, prawej czy do środka kolumny.

enum (VerticalAlignment)

Określa, czy widżety mają być wyrównane do góry, na dole czy na środku kolumny.

object (Widgets)

Tablica widżetów zawartych w kolumnie. Widżety są wyświetlane w kolejności, w jakiej zostały określone.

{

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  }
  // End of list of possible types for union field data.
}

object (TextParagraph)

Widżet TextParagraph.

object (Image)

Widżet Image.

object (DecoratedText)

Widżet DecoratedText.

object (ButtonList)

Widżet ButtonList.

object (TextInput)

Widżet TextInput.

object (SelectionInput)

Widżet SelectionInput.

object (DateTimePicker)

Widżet DateTimePicker.

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

string

Etykieta wyświetlana jako element menu czynności.

object (OnClick)

Działanie onClick dotyczące tego działania.

{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  },
  "widgets": [
    {
      object (FooterWidget)
    }
  ]
}

object (Button)

Przycisk główny stopki stałej. Musi to być przycisk tekstowy z ustawionym tekstem i kolorem.

object (Button)

Dodatkowy przycisk stopki stałej. Musi to być przycisk tekstowy z ustawionym tekstem i kolorem. Jeśli jest ustawiona wartość secondaryButton, musisz też ustawić właściwość primaryButton.

object (FooterWidget)

Lista widżetów znajdujących się w stopce karty. Przycisk główny i dodatkowy są renderowane pod tymi widżetami.

{

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  }
  // End of list of possible types for union field data.
}

object (TextParagraph)

Widżet TextParagraph.

object (DecoratedText)

Widżet DecoratedText.

object (ButtonList)

Widżet ButtonList.

object (TextInput)

Widżet TextInput.

object (DateTimePicker)

[DateTimePicker][google.apps.card.v1.DateTimePIcker] widżet.