Cards v2

object (CardHeader)

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

object (Section)

Zawiera kolekcję widżetów. Każda sekcja ma swój opcjonalny nagłówek. Sekcje są wizualnie oddzielone linią. Przykłady w przypadku aplikacji Google Chat znajdziesz w artykule Definiowanie sekcji karty.

enum (DividerStyle)

Styl podziału między nagłówkiem, sekcjami i stopką.

object (CardAction)

Działania na karcie. Do menu paska narzędzi karty są dodawane działania.

Dostępne w przypadku dodatków do Google Workspace, ale niedostępne w aplikacjach Google Chat.

Na przykład ten fragment kodu JSON tworzy menu akcji 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. Służy jako identyfikator karty w nawigacji po kartach.

Dostępne w przypadku dodatków do Google Workspace, ale niedostępne w aplikacjach Google Chat.

object (CardFixedFooter)

Stała stopka widoczna u dołu tej karty.

Ustawienie parametru fixedFooter bez podania wartości primaryButton lub secondaryButton powoduje błąd. W przypadku aplikacji do obsługi czatu możesz używać stałych stopek w oknach, ale nie w wiadomościach na karcie.

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

enum (DisplayStyle)

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

Dostępne w przypadku dodatków Google Workspace i niedostępne w przypadku aplikacji Google Chat.

object (CardHeader)

Podczas wyświetlania treści kontekstowych nagłówek karty podglądu działa jako element zastępczy, dzięki czemu użytkownik może przełączać się między kartami na stronie głównej a kartami kontekstowymi.

Dostępne w przypadku dodatków Google Workspace i niedostępne w przypadku aplikacji Google Chat.

string

Wymagane. Tytuł nagłówka karty. 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 podany jest tylko tytuł, zajmuje on obie linie.

string

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

enum (ImageType)

Kształt użyty do przycięcia obrazu.

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

string

Adres URL HTTPS obrazu w nagłówku karty.

string

Tekst alternatywny obrazu, który służy do ułatwień dostępu.

string

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

object (Widget)

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

boolean

Wskazuje, czy tę sekcję można zwijać.

Sekcji można nie rozwijać, aby ukryć niektóre lub wszystkie widżety, ale użytkownicy mogą je rozwinąć, aby wyświetlić ukryte widżety, klikając Pokaż więcej. Użytkownicy mogą ponownie ukryć widżety, klikając Pokaż mniej.

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

integer

Liczba widżetów, których nie można zwinąć, które pozostają widoczne nawet wtedy, gdy sekcja jest zwinięta.

Jeśli na przykład sekcja zawiera 5 widżetów, a ustawienie uncollapsibleWidgetsCount jest ustawione na 2, pierwsze 2 widżety są zawsze widoczne, a 3 ostatnie są domyślnie złożone. Wartość uncollapsibleWidgetsCount jest brana pod uwagę tylko wtedy, gdy collapsible jest równa true.

object (CollapseControl)

Opcjonalnie: Zdefiniuj przycisk rozwijania i zwijania sekcji. Ten przycisk będzie widoczny tylko wtedy, gdy sekcję można zwinąć. Jeśli to pole nie jest skonfigurowane, używany jest przycisk domyślny. Dostępny w przypadku aplikacji Google Chat i niedostępny w przypadku dodatków Google Workspace.

enum (HorizontalAlignment)

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

object (TextParagraph)

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

Na przykład ten ciąg JSON tworzy tekst pogrubiony:

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

object (Image)

Wyświetla obraz.

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

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

object (DecoratedText)

Wyświetla ozdobiony element tekstowy.

Na przykład ten kod JSON tworzy ozdobiony widżet tekstowy z adresem e-mail:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "[email protected]",
  "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 ten kod JSON tworzy 2 przyciski. Pierwszy to niebieski przycisk tekstowy, a drugi to przycisk z obrazem, który otwiera link:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 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 ten plik JSON tworzy pole tekstowe adresu e-mail:

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

Kolejny przykład to przykładowy kod JSON, który tworzy pole tekstowe dla języka programowania ze statycznymi sugestiami:

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

object (SelectionInput)

Wyświetla element sterujący, który pozwala użytkownikom wybierać elementy. Elementy sterujące wyborem mogą być polami wyboru, przyciskami opcji, przełącznikami lub menu.

Na przykład ten kod JSON tworzy menu, które pozwala 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 użytkownikom wpisanie daty, godziny lub daty i godziny.

Na przykład ten kod JSON tworzy selektor daty i godziny do planowania spotkania:

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

object (Divider)

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

Na przykład ten kod JSON tworzy separator:

"divider": {
}

object (Grid)

Wyświetla siatkę z kolekcją elementów.

Siatka obsługuje dowolną liczbę kolumn i elementów. Liczba wierszy jest określana przez górną granicę liczby elementów podzieloną przez liczbę kolumn. Siatka z 10 elementami i 2 kolumnami ma 5 wierszy. Siatka z 11 elementami i 2 kolumnami ma 6 wierszy.

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

Na przykład ten plik JSON tworzy siatkę z 2 kolumnami 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 maksymalnie 2 kolumny.

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

Na przykład ten kod JSON tworzy 2 kolumny, z których każda zawiera akapity tekstowe:

"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"
          }
        }
      ]
    }
  ]
}

object (ChipList)

Lista elementów.

Na przykład ten fragment kodu JSON tworzy 2 elementy. Pierwszy to element tekstowy, a drugi to element z ikoną, który otwiera link:

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

Dostępny w przypadku aplikacji Google Chat i niedostępny w przypadku dodatków Google Workspace.

string

Tekst wyświetlany w widżecie.

integer

Maksymalna liczba wierszy tekstu wyświetlanych w widżecie. Jeśli tekst przekracza określoną maksymalną liczbę wierszy, nadmiar treści jest ukryty za pomocą przycisku pokaż więcej. Jeśli tekst jest równy lub krótszy niż określona maksymalna liczba wierszy, przycisk pokaż więcej się nie wyświetli.

Wartość domyślna to 0, co oznacza, że wyświetlany jest cały kontekst. Wartości ujemne są ignorowane. Dostępne w aplikacjach Google Chat i niedostępne w przypadku dodatków do Google Workspace.

string

Adres URL HTTPS, na którym hostowany jest obraz.

Na przykład:

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

object (OnClick)

Gdy użytkownik kliknie obraz, kliknięcie spowoduje to działanie.

string

Tekst alternatywny obrazu, który służy do ułatwień dostępu.

object (Action)

Jeśli jest określony, onClick uruchamia działanie.

object (OpenLink)

Jeśli jest określony, onClickpowoduje działanie polegające na otwarciu linku.

object (Action)

Dodatek uruchamia to działanie, gdy musi otworzyć link. Różni się od openLink powyżej tym, że aby uzyskać link, musi się ono komunikować z serwerem. Z tego względu klient internetowy musi wykonać pewne czynności przygotowawcze, zanim otrzyma odpowiedź działania związaną z otwartym linkiem.

Dostępne w przypadku dodatków do Google Workspace, ale niedostępne w aplikacjach Google Chat.

object (Card)

Po kliknięciu nowa karta jest dodawana do stosu kart (jeśli jest to określone).

Dostępne w przypadku dodatków Google Workspace i niedostępne w przypadku aplikacji Google Chat.

object (OverflowMenu)

Jeśli jest to określone, onClickotworzy menu rozszerzone. Dostępny w przypadku aplikacji Google Chat i niedostępny w przypadku dodatków Google Workspace.

string

Funkcja niestandardowa, która zostanie wywołana, gdy element zawierający zostanie kliknięty lub w inny sposób aktywowany.

Przykładowe zastosowanie znajdziesz w sekcji Czytanie danych z formularza.

object (ActionParameter)

Lista parametrów działania.

enum (LoadIndicator)

Określa wskaźnik ładowania wyświetlany podczas wywoływania działania.

boolean

Wskazuje, czy wartości w formularzu są zachowywane po wykonaniu działania. Wartością domyślną jest false.

Jeśli true, wartości w formularzu pozostają po wywołaniu działania. Aby umożliwić użytkownikowi wprowadzanie zmian podczas przetwarzania działania, ustaw wartość parametru LoadIndicator na NONE. W przypadku wiadomości z karty w aplikacjach do obsługi czatu musisz też ustawićResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseTypeResponseType

Jeśli jest ustawiona na false, wartości formularza są wyczyszczane po uruchomieniu działania. Aby uniemożliwić użytkownikowi wprowadzanie zmian podczas przetwarzania działania, ustaw wartość parametru LoadIndicator na SPINNER.

enum (Interaction)

Opcjonalnie: Wymagany podczas otwierania okna dialogowego.

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

Jeśli nie zostanie określone, aplikacja zareaguje, wykonującactionjak na przykład otwarcie linku lub wykonanie funkcji.

Po podaniu wartości interaction aplikacja może reagować w specjalny sposób. Na przykład ustawienie wartościinteractionnaOPEN_DIALOG spowoduje, że aplikacja otworzy okno. Jeśli ją określisz, wskaźnik wczytywania nie będzie się wyświetlał. Jeśli określisz dodatek w przypadku dodatku, cała karta będzie usunięta i nic nie będzie widoczne w kliencie.

Dostępny w przypadku aplikacji Google Chat i niedostępny w przypadku dodatków Google Workspace.

string

Jeśli podczas wywołania tego działania wymienione tu widżety nie mają wartości, przesłanie formularza zostanie przerwane.

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

boolean

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

string

Nazwa parametru skryptu działania.

string

Wartość parametru.

string

Adres URL do otwarcia.

enum (OpenAs)

Jak otworzyć link.

Dostępne w przypadku dodatków Google Workspace i niedostępne w przypadku aplikacji Google Chat.

enum (OnClose)

Czy klient zapomina o linku po jego otwarciu, czy obserwuje go do czasu zamknięcia okna.

Dostępne w przypadku dodatków do Google Workspace, ale niedostępne w aplikacjach Google Chat.

object (OverflowMenuItem)

Wymagane. Lista opcji menu.

object (Icon)

Ikona wyświetlana przed tekstem.

string

Wymagane. Tekst, który identyfikuje lub opisuje produkt użytkownikom.

object (OnClick)

Wymagane. Działanie wywoływane po wybraniu opcji menu. Ten element OnClick nie może zawierać OverflowMenu, a wszystkie określone OverflowMenu zostaną usunięte, a element menu wyłączony.

boolean

Czy opcja menu jest wyłączona. Wartość domyślna to fałsz.

string

Opcjonalnie: Opis ikony używanej w ułatwieniach dostępu. Jeśli nie podasz wartości, zostanie użyta wartość domyślna Button. Zgodnie ze sprawdzoną metodą należy podać opis, który wyjaśnia, co przedstawia ikona, oraz, w stosownych przypadkach, co ona robi. 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/workspace/chat.

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

enum (ImageType)

Styl przycinania zastosowany do obrazu. W niektórych przypadkach zastosowanie przycięcia CIRCLEpowoduje, że obraz będzie wyświetlany większy niż wbudowana ikona.

string

Wyświetl jedną z wbudowanych ikon Google Workspace.

Aby na przykład wyświetlić ikonę samolotu, użyj parametru AIRPLANE. W przypadku autobusu podaj wartość BUS.

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

string

wyświetlać ikonę niestandardową pod adresem URL HTTPS.

Na przykład:

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

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

object (MaterialIcon)

Wyświetl jedną z ikon Material Google.

Aby na przykład wyświetlić ikonę pola wyboru, użyj

"materialIcon": {
  "name": "check_box"
}

Dostępny w przypadku aplikacji Google Chat i niedostępny w przypadku dodatków Google Workspace.

string

Nazwa ikony zdefiniowana w Materiałach Google, np. check_box. Nieprawidłowe nazwy są pomijane i zastępowane pustym ciągiem, co powoduje, że ikona nie jest renderowana.

boolean

Określa, czy ikona jest wyświetlana jako wypełniona. Wartość domyślna to false (fałsz).

Aby wyświetlić podgląd różnych ustawień ikon, otwórz Ikony czcionek Google i zmień ustawienia w sekcji Dostosuj.

integer

Grubość kreski ikony. Wybierz jedną z tych wartości: {100, 200, 300, 400, 500, 600, 700}. Jeśli nie zostanie podany, wartością domyślną jest 400. Jeśli podasz inną wartość, zostanie użyta wartość domyślna.

Aby wyświetlić podgląd różnych ustawień ikon, otwórz Google Fonts (Ikony czcionek Google) i dostosuj ustawienia w sekcji Customize (Dostosuj).

integer

Waga i stopień wpływają na grubość symbolu. Zmiany oceny są bardziej szczegółowe niż korekty wagi i mają niewielki wpływ na wielkość symbolu. Masz do wyboru {-25, 0, 200}. Jeśli nie ma tej wartości, domyślnie jest to 0. Jeśli podasz inną wartość, zostanie użyta wartość domyślna.

Aby wyświetlić podgląd różnych ustawień ikon, otwórz Google Fonts (Ikony czcionek Google) i dostosuj ustawienia w sekcji Customize (Dostosuj).

object (Icon)

Wycofane na rzecz startIcon.

object (Icon)

Ikona wyświetlana przed tekstem.

string

Tekst wyświetlany nad text. Zawsze skraca.

string

Wymagane. Tekst główny.

Obsługuje proste formatowanie. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach Google Workspace.

boolean

Ustawienie zawijania tekstu. Jeśli zaznaczysz opcję true, tekst zostanie przeniesiony i wyświetlony na kilku wierszach. W przeciwnym razie tekst zostanie obcięty.

Dotyczy tylko właściwości text, a nie topLabel ani bottomLabel.

string

Tekst wyświetlany pod text. Zawsze zawija.

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 wykonać określone działanie.

object (SwitchControl)

Element przełącznika, który użytkownik może kliknąć, aby zmienić jego stan i wywołać działanie.

object (Icon)

Ikona wyświetlana po tekście.

Obsługuje ikony wbudowane i niestandardowe.

string

Tekst wyświetlany wewnątrz przycisku.

object (Icon)

Ikona wyświetlana na przycisku. Jeśli ustawisz zarówno parametr icon, jak i text, ikona pojawi się przed tekstem.

object (Color)

Opcjonalnie: Kolor przycisku. Jeśli jest ustawiony, przycisk type ma wartość FILLED, a kolor pól text i icon jest ustawiony na kontrast, by zwiększyć czytelność. Jeśli np. kolor przycisku jest ustawiony na niebieski, tekst lub ikony w przycisku są białe.

Aby ustawić kolor przycisku, określ wartości pól red, green i blue. Wartość musi być liczbą zmiennoprzecinkową z zakresu od 0 do 1 na podstawie wartości koloru RGB, gdzie 0 (0/255) oznacza brak koloru, a 1 (255/255) – jego maksymalną intensywność.

Na przykład następujący kod ustawia kolor czerwony na maksymalną intensywność:

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

Pole alpha jest niedostępne w przypadku koloru przycisku. Jeśli jest określone, to pole jest ignorowane.

object (OnClick)

Wymagane. Działanie, które ma zostać wykonane po kliknięciu przycisku przez użytkownika, np. otwarcie hiperlinku lub wykonanie funkcji niestandardowej.

boolean

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

string

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

Ustaw tekst opisowy, który informuje użytkowników, do czego służy przycisk. Jeśli na przykład przycisk otwiera hiperlink, możesz napisać: „Otwiera nową kartę przeglądarki i powoduje przejście do dokumentacji Google Chat dla deweloperów na stronie https://developers.google.com/workspace/chat"”.

enum (Type)

Opcjonalnie: Typ przycisku. Jeśli nie jest ustawiony, typ przycisku przyjmuje domyślnie wartość OUTLINED. Jeśli pole color jest skonfigurowane, typ przycisku jest wymuszony na FILLED, a wartość ustawiona w tym polu jest ignorowana.

Dostępne w aplikacjach Google Chat i niedostępne w przypadku dodatków do Google Workspace.

number

Ilość czerwonego koloru jako wartość z przedziału [0, 1].

number

Ilość zieleni w kolorze jako wartość z zakresu [0, 1].

number

Ilość niebieskiego koloru jako wartość z przedziału [0, 1].

number

Część tego koloru, która powinna zostać zastosowana do piksela. Oznacza to, że ostateczny kolor piksela jest określany za pomocą tej zależności:

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

Oznacza to, że wartość 1,0 odpowiada jednolitemu kolorowi, a wartość 0,0 – całkowicie przezroczystemu kolorowi. Zamiast prostego wektora liczby zmiennoprzecinkowej używa ona komunikatu opakowania, aby można było odróżnić wartość domyślną od wartości nieskonfigurowanej. Jeśli go pominiesz, obiekt koloru zostanie wyrenderowany jako jednolity kolor (jak gdyby wartość alfa miała wartość 1,0).

string

Nazwa, pod którą widżet przełącznika jest identyfikowany w zdarzeniu wprowadzania danych w formularzu.

Szczegółowe informacje o pracy z danymi formularza znajdziesz w artykule Odbieranie danych formularza.

string

Wartość wpisana przez użytkownika, zwrócona w ramach zdarzenia wprowadzania danych w formularzu.

Szczegółowe informacje o pracy z danymi formularza znajdziesz w artykule Odbieranie danych formularza.

boolean

Gdy true, przełącznik jest wybrany.

object (Action)

Działanie, które ma zostać wykonane po zmianie stanu przełącznika, np. jaka funkcja ma zostać uruchomiona.

enum (ControlType)

Wygląd przełącznika w interfejsie.

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

object (Button)

Tablica przycisków.

string

Nazwa, za pomocą której pole tekstowe jest identyfikowane w zdarzeniu wprowadzania danych w formularzu.

Szczegółowe informacje o pracy z danymi formularza znajdziesz w artykule Odbieranie danych formularza.

string

Tekst wyświetlany nad polem tekstowym w interfejsie.

Podaj tekst, który pomoże użytkownikowi podać informacje wymagane przez aplikację. Jeśli na przykład pytasz czyjś imię, a konkretnie nazwisko, wpisz surname zamiast name.

Wymagane, jeśli właściwość hintText nie jest określona. W przeciwnym razie jest to opcjonalne.

string

Tekst wyświetlany pod polem tekstowym, który ma pomóc użytkownikom w wpisaniu określonej wartości. Ten tekst jest zawsze widoczny.

Wymagane, jeśli właściwość label nie jest określona. W przeciwnym razie jest to opcjonalne.

string

Wartość wpisana przez użytkownika, zwracana w ramach zdarzenia wprowadzenia danych w formularzu.

Szczegółowe informacje o pracy z danymi formularza znajdziesz w artykule Odbieranie danych formularza.

enum (Type)

Jak pole tekstowe wygląda w interfejsie na przykład czy to pole jest jedno- czy wielowierszowe.

object (Action)

Co zrobić, gdy nastąpi zmiana w polu tekstowym. Może to być na przykład dodanie tekstu do pola lub jego usunięcie.

Może to być na przykład uruchomienie funkcji niestandardowej 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ą w polu tekstowym. Gdy użytkownicy wpisują tekst, sugerowane wartości są dynamicznie filtrowane, aby pasowały do tego, co wpisują.

Na przykład pole do wprowadzania tekstu w języku programowania może zawierać sugestie Javy, JavaScriptu, Pythona i C++. Gdy użytkownicy zaczną pisać Jav, na liście filtrów sugestii wyświetlą się tylko Java i JavaScript.

Sugerowane wartości pomagają zachęcać użytkowników do wpisywania wartości, które Twoja aplikacja może zrozumieć. W przypadku JavaScript niektórzy użytkownicy mogą wpisaćjavascript, a innijava script. Sugerowanie JavaScript może ujednolicić sposób interakcji użytkowników z aplikacją.

Gdy jest określona, TextInput.type ma zawsze wartość SINGLE_LINE, nawet jeśli ustawiona jest wartość MULTIPLE_LINE.

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

object (Action)

Opcjonalnie: Określ, jakie działanie ma być wykonywane, gdy pole tekstowe wyświetla sugestie użytkownikom, którzy z niego korzystają.

Jeśli nie podasz żadnej wartości, sugestie zostaną ustawione przez initialSuggestions i przetworzone przez klienta.

Jeśli określisz działanie, aplikacja wykona określone tutaj działanie, np. uruchomi funkcję niestandardową.

Dostępne w przypadku dodatków do Google Workspace, ale niedostępne w aplikacjach Google Chat.

object (Validation)

Dostępny w przypadku aplikacji Google Chat i dodatków do Google Workspace.

string

Tekst, który pojawia się w polu tekstowym, gdy jest puste. Użyj tego tekstu, aby poprosić użytkowników o wpisanie wartości. Na przykład: Enter a number from 0 to 100.

Dostępne w aplikacjach Google Chat i niedostępne w przypadku dodatków do Google Workspace.

Action

Navigation

Push lub aktualizowanie wyświetlanych kart.

Card

Stos kart przesuwa kartę na stos kart.

Card

Grupa kart aktualizuje największą kartę, dodając nową kartę, i zachowuje wartości pól wypełnionych formularzy. W przypadku nierównego pola wartość jest pomijana.

object (SuggestionItem)

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

string

Wartość sugerowanego tekstu w polu tekstowym. Jest to odpowiednik danych wpisywanych przez użytkowników.

integer

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

enum (InputType)

Dostępny w przypadku aplikacji Google Chat i dodatków do Google Workspace.

string

Wymagane. Nazwa identyfikująca dane wejściowe wyboru w zdarzeniu z danymi wejściowymi formularza.

Szczegółowe informacje o pracy z danymi formularza znajdziesz w artykule Odbieranie danych formularza.

string

Tekst wyświetlany nad polem wyboru w interfejsie.

Podaj tekst, który pomoże użytkownikowi podać informacje, których potrzebuje Twoja aplikacja. Jeśli na przykład użytkownicy wybierają pilność zgłoszenia w menu, etykieta może brzmieć „Pilność” lub „Wybierz pilność”.

enum (SelectionType)

Typ elementów wyświetlanych użytkownikom w SelectionInputwidżecie. Typy wyboru obsługują różne typy interakcji. Użytkownicy mogą na przykład zaznaczyć jedno lub więcej pól wyboru, ale tylko jedną wartość w menu.

object (SelectionItem)

Tablica elementów do wyboru. Może to być np. tablica przycisków opcji lub pól wyboru. Obsługuje do 100 elementów.

object (Action)

Jeśli to możliwe, formularz jest przesyłany, gdy zmieni się wybór. Jeśli nie określisz tego parametru, musisz podać oddzielny przycisk, który przesyła formularz.

Szczegółowe informacje o pracy z danymi wejściowymi formularza znajdziesz w artykule Odbieranie danych formularza.

integer

W przypadku menu z wieloma opcjami maksymalna liczba elementów, które użytkownik może wybrać. Minimalna wartość to 1 element. Jeśli nie podasz tej wartości, zostanie użyta domyślna liczba 3.

integer

W przypadku menu z wielokrotnie wybieranymi opcjami liczba znaków tekstowych wpisywanych przez użytkownika, zanim menu zwróci sugerowane elementy do wyboru.

Jeśli nie skonfigurujesz menu wyboru wielokrotnego, zostaną użyte te wartości domyślne:

• Jeśli menu używa stałego tablicę elementów SelectionInput, domyślnie ma 0 znaków i natychmiast wypełnia elementy z tablicy.
• Jeśli menu korzysta z dynamicznego źródła danych (multi_select_data_source), domyślnie przyjmuje się 3 znaki, zanim wyślesz zapytanie do źródła danych w celu zwrócenia sugerowanych elementów.

object (Validation)

Weryfikacja tego pola wyboru w przypadku menu rozwijanych.

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace.

object (Action)

zewnętrzne źródło danych, np. relacyjna baza danych;

object (PlatformDataSource)

Źródło danych z Google Workspace.

string

Tekst, który identyfikuje lub opisuje produkt dla użytkowników.

string

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

Szczegółowe informacje o pracy z danymi formularza znajdziesz w artykule Odbieranie danych formularza.

boolean

Określa, czy element jest wybierany domyślnie. Jeśli pole wyboru akceptuje tylko jedną wartość (np. w przypadku przycisków opcji lub menu), ustaw to pole tylko w przypadku jednego elementu.

string

W przypadku menu wielokrotnego wyboru adres URL ikony wyświetlany obok pola text elementu. Obsługuje pliki PNG i JPEG. Musi być adresem URL usługi HTTPS. Na przykład:https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.

string

W przypadku menu z wieloma opcjami tekstowy opis lub etykieta wyświetlane pod polem textelementu.

enum (CommonDataSource)

Źródło danych udostępniane przez wszystkie aplikacje Google Workspace, np. użytkowników w organizacji Google Workspace.

object (HostAppDataSourceMarkup)

Źródło danych, które jest unikalne dla aplikacji hosta Google Workspace, takiej jak pokoje w Google Chat.

To pole obsługuje biblioteki klienta interfejsów API Google, ale nie jest dostępne w bibliotekach klienta Cloud. Więcej informacji znajdziesz w sekcji Instalowanie bibliotek klienta.

object (ChatClientDataSourceMarkup)

Źródło danych z Google Chat.

object (SpaceDataSource)

pokoje Google Chat, których użytkownik jest członkiem;

boolean

Jeśli ustawisz tę opcję na true, menu wielokrotnego wyboru domyślnie wybierze bieżący pokój Google Chat jako element.

string

Nazwa, pod którą obiekt DateTimePicker jest identyfikowany w zdarzeniu danych wejściowych formularza.

Szczegółowe informacje o pracy z danymi formularza znajdziesz w artykule Odbieranie danych formularza.

string

Tekst, który zachęca 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ść na podstawie typu selektora (DateTimePickerType):

• DATE_AND_TIME: data i godzina w formacie kalendarzowym w UTC. Na przykład aby uwzględnić 1 stycznia 2023 r. o 12:00 czasu UTC, użyj właściwości 1672574400000.
• DATE_ONLY : data kalendarzowa o godzinie 00:00:00 UTC. Na przykład, aby wskazać 1 stycznia 2023 r., użyj wartości 1672531200000.
• TIME_ONLY: czas w strefie czasowej UTC. Aby na przykład podać godzinę 12:00, użyj 43200000 (lub 12 * 60 * 60 * 1000).

integer

Liczba reprezentująca przesunięcie strefy czasowej względem UTC w minutach. Jeśli jest ustawiona, valueMsEpoch jest wyświetlany w określonej strefie czasowej. Jeśli nie jest skonfigurowana, przyjmuje się domyślne ustawienie strefy czasowej użytkownika.

object (Action)

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

object (Validation)

Dostępny w przypadku aplikacji Google Chat i dodatków do Google Workspace.

string

Tekst wyświetlany w nagłówku siatki.

object (GridItem)

Elementy wyświetlane w siatce.

object (BorderStyle)

Styl obramowania, który ma być stosowany do każdego elementu siatki.

integer

Liczba kolumn wyświetlanych w siatce. Jeśli to pole nie jest określone, używana jest wartość domyślna, która różni się w zależności od tego, gdzie jest wyświetlana siatka (w dialogu lub w usługach towarzyszących).

object (OnClick)

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

string

Określony przez użytkownika identyfikator 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 dla elementu siatki.

string

Adres URL obrazu.

string

Etykieta ułatwień dostępu dla obrazu.

object (ImageCropStyle)

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

object (BorderStyle)

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

enum (ImageCropType)

Typ przycięcia.

number

Format obrazu, który ma być użyty, jeśli typ przycięcia to RECTANGLE_CUSTOM.

Oto przykład zastosowania formatu 16:9:

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

enum (BorderType)

Typ obramowania.

object (Color)

Kolory, których należy używać, gdy typ to BORDER_TYPE_STROKE.

Aby ustawić kolor obrysu, określ wartość w polach red, green i blue. Wartość musi być liczbą zmiennoprzecinkową z zakresu 0–1 na podstawie wartości koloru RGB, gdzie:0(0/255) oznacza brak koloru, a 1(255/255) – maksymalną intensywność koloru.

Na przykład następujący kod ustawia kolor czerwony na maksymalną intensywność:

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

Pole alpha jest niedostępne w przypadku koloru kreski. Jeśli jest określone, to pole jest ignorowane.

integer

Promień zaokrąglenia rogów.

object (Column)

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

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ą się znajdować na górze, 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.

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.

object (ChipList)

Widżet ChipList. Dostępny w przypadku aplikacji Google Chat i niedostępny w przypadku dodatków Google Workspace.

enum (Layout)

Określony układ listy elementów.

object (Chip)

Tablica elementów.

object (Icon)

Obraz ikony. Jeśli ustawisz zarówno parametr icon, jak i text, ikona pojawi się przed tekstem.

string

Tekst wyświetlany wewnątrz elementu.

object (OnClick)

Opcjonalnie: Działanie, które ma zostać wykonane, gdy użytkownik kliknie element, np. otwarcie hiperlinku lub wykonanie funkcji niestandardowej.

boolean

Określa, czy element jest aktywny i reaguje na działania użytkownika. Domyślna wartość to true. Rola wycofana. Zamiast tego użyj kolumny disabled.

boolean

Określa, czy element jest nieaktywny i ignoruje działania użytkownika. Domyślna wartość to false.

string

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

Ustaw tekst opisowy, który informuje użytkowników, do czego służy dany element. Jeśli na przykład element otwiera hiperlink, napisz: „Otwiera nową kartę przeglądarki i przechodzi do dokumentacji dla programistów Google Chat na stronie https://developers.google.com/workspace/chat".

enum (HorizontalAlignment)

Ustawienie poziome przycisku rozwijania i zwijania.

object (Button)

Opcjonalnie: Zdefiniuj przycisk konfigurowalny, aby rozwinąć tę sekcję. Należy ustawić pola expandButton i collapseButton. Tylko 1 z nich nie zostanie zastosowany. Jeśli to pole nie jest skonfigurowane, używany jest przycisk domyślny.

object (Button)

Opcjonalnie: Zdefiniuj konfigurowalny przycisk, aby zwinąć sekcję. Należy ustawić pola expandButton i collapseButton. Tylko 1 z nich nie zostanie zastosowany. Jeśli to pole nie jest skonfigurowane, używany jest przycisk domyślny.

string

Etykieta wyświetlana jako element menu działania.

object (OnClick)

onClickDziałanie związane z tym działaniem.

object (Button)

Główny przycisk stopki stałej. Przycisk musi być przyciskiem tekstowym z ustawionym tekstem i kolorem.

object (Button)

Drugi przycisk w nieruchomym stopce. Przycisk musi być tekstowym przyciskiem z tekstem i kolorem. Jeśli ustawiona jest wartość secondaryButton, musisz też ustawić primaryButton.