Cards v2

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

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 własny, 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 sekcjami.

object (CardAction)

Działania na karcie. Działania są dodawane do menu na pasku narzędzi karty.

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

Na przykład ten plik JSON tworzy menu czynności karty z Settings oraz Send Feedback opcje:

"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żywany jako identyfikator karty w nawigacji po kartach.

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

object (CardFixedFooter)

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

Ustawienie fixedFooter bez określania primaryButton lub secondaryButton powoduje błąd. W aplikacjach do obsługi czatu możesz użyć stałych stopek w okna, ale nie wiadomości z kart.

Dostępny 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 pełni funkcję obiektu zastępczego, dzięki któremu użytkownik może przechodzić między kartami na stronie głównej a kartami kontekstowymi.

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

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

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 określono tylko tytuł, tekst zajmuje oba wiersze.

string

Podtytuł nagłówka karty. Jeśli została określona, pojawia się w osobnym wierszu pod nagłówkiem title

enum (ImageType)

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

Dostępne dla 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.

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

string

Tekst widoczny 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 jeden widżet.

boolean

Wskazuje, czy 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, wpisz uncollapsibleWidgetsCount

integer

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

Na przykład, jeśli sekcja zawiera pięć widżetów, a sekcja uncollapsibleWidgetsCount jest ustawiona na 2, pierwsze dwa widżety są zawsze widoczne, a trzy ostatnie są domyślnie zwinięte. uncollapsibleWidgetsCount jest brany pod uwagę tylko wtedy, collapsible to true

object (CollapseControl)

Opcjonalnie: Zdefiniuj przycisk rozwijania i zwijania sekcji. Ten przycisk jest widoczny tylko w przypadku zwijania sekcji. Jeśli to pole nie jest skonfigurowane, używany jest przycisk domyślny. Dostępny w aplikacjach Google Chat i niedostępny w przypadku dodatków do Google Workspace.

{
  "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)
  },
  "chipList": {
    object (ChipList)
  }
  // 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 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 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 plik JSON tworzy widżet dekorowanego tekstu 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 ten plik 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 umożliwia użytkownikom wybieranie elementów. Elementy sterujące zaznaczaniem mogą być polami wyboru, opcjami, przełącznikami i menu.

Na przykład ten plik 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 plik JSON tworzy selektor daty i godziny w celu zaplanowania spotkania:

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

object (Divider)

Wyświetla poziomą linię rozdzielającą widżety.

Na przykład ten kod JSON tworzy separator:

"divider": {
}

object (Grid)

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

Siatka może zawierać dowolną liczbę kolumn i elementów. Liczba wierszy jest określana przez górne granice liczby elementów podzielone 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 dla 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 funkcji Grid widżet.

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

"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 plik JSON tworzy 2 elementy. Pierwszy to element tekstowy, a drugi to ikona, która otwiera link:

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

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

{
  "text": string,
  "maxLines": integer
}

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 krótszy niż określona maksymalna liczba wierszy, przycisk pokaż więcej nie jest wyświetlany.

Wartość domyślna to 0. W takim przypadku widoczny jest cały kontekst. Wartości ujemne są ignorowane. Dostępny w przypadku aplikacji Google Chat i niedostępny w przypadku dodatków Google Workspace.

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

string

Adres URL HTTPS, który hostuje 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.

{

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

object (Action)

Jeśli określisz działanie, będzie ono wywoływane przez onClick

object (OpenLink)

Jeśli zostanie określony, onClick uruchamia działanie otwartego linku.

object (Action)

Dodatek wyzwala to działanie, gdy wymagane jest otwarcie linku. Różni się to od openLink powyżej, ponieważ aby uzyskać link, należy komunikować się z serwerem. Z tego względu klient internetowy musi wykonać pewne działania przygotowawcze, zanim otrzyma odpowiedź działania związaną z otwartym linkiem.

Dostępne w przypadku dodatków do Google Workspace, a 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 do Google Workspace, a niedostępne w aplikacjach Google Chat.

object (OverflowMenu)

Jeśli zostanie określony, onClick otwiera rozszerzone menu. Dostępny w aplikacjach Google Chat i niedostępny w przypadku dodatków do Google Workspace.

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

string

Funkcja niestandardowa wywoływana po kliknięciu lub w inny sposób aktywowanego elementu zawierającego jej treść.

Na przykład informacje o wykorzystaniu znajdziesz w artykule Odczytywanie danych formularzy.

object (ActionParameter)

Lista parametrów działań.

enum (LoadIndicator)

Określa wskaźnik wczytywania, który wyświetla się podczas wezwania do działania.

boolean

Wskazuje, czy wartości formularza utrzymują się po wykonaniu działania. Wartość domyślna to false

Jeśli true, wartości formularza pozostają po wywołaniu działania. Aby umożliwić użytkownikowi wprowadzanie zmian w trakcie przetwarzania działania, ustaw: LoadIndicator do NONE Dla: wiadomości z kart w aplikacjach do obsługi czatu, musisz też ustawić działanie ResponseType. do UPDATE_MESSAGE i użyj tych samych wartości cardId z karty, która zawiera działanie.

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

enum (Interaction)

Opcjonalnie: Wymagane przy otwieraniu okno.

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

Jeśli nie określono inaczej, aplikacja zareaguje, wykonując action – np. otwarcie linku lub uruchomienie funkcji.

Określając parametr interaction, aplikacja może odpowiadać w specjalny sposób interaktywny. Na przykład: interaction do OPEN_DIALOG, aplikacja może otwierać okno. Jeśli jest określone, wskaźnik wczytywania nie jest wyświetlany. 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 aplikacjach Google Chat i niedostępny w przypadku dodatków do 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 dla aplikacji Google Chat i dodatków do Google Workspace.

boolean

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

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

string

Nazwa parametru skryptu działania.

string

Wartość parametru.

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

string

Adres URL do otwarcia.

enum (OpenAs)

Jak otworzyć link.

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

enum (OnClose)

Czy po otwarciu linku klient zapomni o otwartym linku czy obserwuje go do momentu zamknięcia okna.

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

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

object (OverflowMenuItem)

Wymagane. Lista opcji menu.

{
  "startIcon": {
    object (Icon)
  },
  "text": string,
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean
}

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 OnClick nie może zawierać OverflowMenu, dowolny określony OverflowMenu zostanie usunięte, a pozycja menu wyłączona.

boolean

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

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

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

string

Opcjonalnie: Opis ikony używanej w ułatwieniach dostępu. Jeśli nie podasz wartości, zostanie użyta wartość domyślna Button. Najlepiej jest ustawić przydatny opis zawartości ikony i – w odpowiednich przypadkach – do czego służy. 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 Button, altText pojawia się jako tekst pomocniczy, gdy użytkownik najedzie kursorem na przycisk. 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 dostępnych w Google Workspace.

Na przykład, aby wyświetlić ikonę samolotu, wpisz AIRPLANE W przypadku autobusu wpisz BUS

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

string

Wyświetlanie niestandardowej ikony hostowanej pod adresem URL HTTPS.

Na przykład:

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

Obsługiwane typy plików obejmują .png oraz .jpg

object (MaterialIcon)

Wyświetl jedną z Ikony 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.

{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}

string

Nazwa ikony zdefiniowana w Google Material Icon, check_box Nieprawidłowe nazwy są odrzucane 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.

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

integer

Grubość kreski ikony. Masz do wyboru opcje: {100, 200, 300, 400, 500, 600, 700}. Jeśli nie jest obecny, jego domyślną wartością jest 400. Jeśli podasz inną wartość, zostanie użyta wartość domyślna.

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

integer

Grubość linii symbolu zależy od wagi i grubości. Zmiany oceny są bardziej szczegółowe niż korekty wagi i mają niewielki wpływ na wielkość symbolu. Wybierz jedną z wartości {-25, 0, 200}. Jeśli go nie podano, domyślną wartością jest 0. Jeśli podasz inną wartość, zostanie użyta wartość domyślna.

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

{
  "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, zastępując startIcon

object (Icon)

Ikona wyświetlana przed tekstem.

string

Tekst widoczny powyżej text Zawsze skraca.

string

Wymagane. Tekst główny.

Obsługuje proste formatowanie. Więcej informacji o formatowaniu tekstu znajdziesz w sekcji Formatowanie tekstu w aplikacjach Google Chat oraz Formatowanie tekstu w dodatkach do Google Workspace

boolean

Ustawienie zawijania tekstu. Jeśli true, tekst zawija się i wyświetla w kilku wierszach. W przeciwnym razie tekst zostanie obcięty.

Dotyczy tylko text, nie topLabel oraz bottomLabel

string

Tekst widoczny poniżej text Zawsze zawija.

object (OnClick)

To działanie jest wywoływane, gdy użytkownik kliknie 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ć swój stan i wywołać działanie.

object (Icon)

Ikona wyświetlana po tekście.

Obsługiwane wbudowany oraz niestandardowy .

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

string

Tekst wyświetlany na przycisku.

object (Icon)

Ikona wyświetlana wewnątrz przycisku. Jeśli oba icon oraz text zostanie ustawiona, ikona pojawi się przed tekstem.

object (Color)

Opcjonalnie: Kolor przycisku. Jeśli jest ustawiony, przycisk type jest ustawiona na FILLED oraz kolor text oraz icon mają kontrastowy kolor, aby zwiększyć czytelność. Jeśli np. kolor przycisku jest niebieski, wszystkie fragmenty tekstu i ikony na przycisku są białe.

Aby ustawić kolor przycisku, podaj w atrybucie 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.

W przykładzie poniżej pokazujemy, że kolor jest czerwony z maksymalną intensywnością:

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

alpha pole jest niedostępne dla koloru przycisku. Jeśli pole jest określone, jest ignorowane.

object (OnClick)

Wymagane. Działanie, które ma być wykonywane po kliknięciu przycisku przez użytkownika, na przykład otwarcie hiperlinku lub uruchomienie 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 opis, który poinformuje użytkowników o działaniu przycisku. Jeśli na przykład przycisk otwiera hiperlink, możesz napisać: „Otwiera nową kartę przeglądarki i przechodzi do dokumentacji dla deweloperów Google Chat na stronie https://developers.google.com/workspace/chat".

enum (Type)

Opcjonalnie: Typ przycisku. Jeśli zasada jest nieskonfigurowana, domyślnym typem przycisku jest OUTLINED Jeśli color jest ustawiony, typ przycisku musi być FILLED i wszelkie wartości ustawione w tym polu będą ignorowane.

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

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

number

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

number

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

number

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

number

Część tego koloru, która powinna zostać zastosowana do piksela. Oznacza to, że końcowy kolor w pikselach jest określony za pomocą tego równania:

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

Oznacza to, że wartość 1,0 oznacza kolor jednolity, a wartość 0,0 – kolor całkowicie przezroczysty. Wykorzystuje komunikat opakowany, a nie prosty zmiennoprzecinkowy element skalarny, dzięki czemu można odróżnić wartość domyślną od nieskonfigurowanej wartości. Pominięcie tego obiektu koloru powoduje, że jest on renderowany jako jednolity kolor (jak gdyby wartość alfa miała jawnie 1,0).

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

string

Nazwa, według której 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 wejściowymi formularza znajdziesz w artykule Odbieranie danych formularzy.

boolean

Kiedy true, przełącznik jest wybrany.

object (Action)

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

enum (ControlType)

Wygląd przełącznika w interfejsie.

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

{
  "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)
  },
  "validation": {
    object (Validation)
  },
  "placeholderText": string
}

string

Nazwa, pod którą wpisany tekst jest rozpoznawany w zdarzeniu wprowadzania tekstu.

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

string

Tekst wyświetlany nad polem do wprowadzania tekstu w interfejsie.

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

Wymagany, jeśli hintText nie określono. W przeciwnym razie jest to opcjonalne.

string

Tekst wyświetlany pod polem do wprowadzania tekstu, który ma ułatwić użytkownikom wpisanie określonej wartości. Ten tekst jest zawsze widoczny.

Wymagany, jeśli label nie określono. W przeciwnym razie jest to opcjonalne.

string

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

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

enum (Type)

Sposób wyświetlania pola do wprowadzania tekstu w interfejsie. na przykład czy to pole jest jedno- czy wielowierszowe.

object (Action)

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

Przykładowe działania to uruchomienie funkcji niestandardowej lub otwarcie okno w Google Chat.

object (Suggestions)

Sugerowane wartości, które użytkownicy mogą wpisać. Te wartości pojawiają się po kliknięciu przez użytkownika pola do wprowadzania tekstu. W miarę pisania przez użytkowników sugerowane wartości są dynamicznie filtrowane zgodnie z tym, co wpisujesz.

Na przykład pole tekstowe do wprowadzania danych w języku programowania może sugerować Java, JavaScript, Python i C++. Gdy użytkownicy zaczną pisać Jav, listę filtrów sugestii, które pozwalają wyświetlać tylko Java oraz JavaScript

Sugerowane wartości pomagają zachęcać użytkowników do wpisywania wartości, które Twoja aplikacja może zrozumieć. W przypadku JavaScriptu niektórzy użytkownicy mogą wpisać javascript i inne java script Sugerowanie JavaScript pozwalają ustandaryzować sposób, w jaki użytkownicy korzystają z aplikacji.

Jeśli określisz parametr, TextInput.type to zawsze SINGLE_LINE, nawet jeśli ustawiona jest wartość MULTIPLE_LINE

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

object (Action)

Opcjonalnie: Określ, co ma się stać, gdy pole do wprowadzania tekstu będzie podpowiadać użytkownikom, którzy z niego korzystają.

Jeśli nie określono inaczej, sugestie będą generowane przez initialSuggestions i przetwarzane przez klienta.

Jeśli jest określony, aplikacja wykonuje tutaj określone działanie, np. wywołuje funkcję niestandardową.

Dostępne w przypadku dodatków Google Workspace i niedostępne w przypadku aplikacji 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 do wprowadzania tekstu, gdy pole jest puste. Wpisz w nim wartość, korzystając z tego tekstu. Na przykład:Enter a number from 0 to 100.

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

Action

Navigation

Przekaż lub zaktualizuj wyświetlone karty.

Card

Stos kart przesuwa kartę na stos kart.

Card

Stos kart aktualizuje górną kartę o nową kartę i zachowuje wartości wypełnionych pól formularza. W przypadku pola, które nie jest równoważne, wartość jest usuwana.

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

object (SuggestionItem)

Lista sugestii używanych do autouzupełniania rekomendacji w polach do 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 tekstu w polu tekstowym. Jest to odpowiednik danych wpisywanych przez użytkowników.

{
  "characterLimit": integer,
  "inputType": enum (InputType)
}

integer

Dostępny 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.

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

  // Union field multi_select_data_source can be only one of the following:
  "externalDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
  // End of list of possible types for union field multi_select_data_source.
}

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 w interfejsie nad polem wyboru do wprowadzania danych.

Podaj tekst, który pomoże użytkownikowi podać informacje, których potrzebuje Twoja aplikacja. Jeśli na przykład użytkownicy wybierają z menu pilność zgłoszenia do pracy, etykieta może mieć etykietę „Pilne”. lub „Wybierz pilność”.

enum (SelectionType)

Typ produktów wyświetlanych użytkownikom w SelectionInput widżet. Typy wyboru obsługują różne typy interakcji. Użytkownicy mogą na przykład zaznaczyć co najmniej jedno pole wyboru, ale w menu mogą wybrać tylko jedną wartość.

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 określisz formularz, zostanie on przesłany po zmianie wyboru. Jeśli go nie podasz, musisz dodać osobny przycisk do przesyłania formularza.

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

integer

W przypadku menu wielokrotnego wyboru jest to maksymalna liczba elementów, które użytkownik może wybrać. Minimalna wartość to 1 element. Jeśli nie określono inaczej, domyślna wartość to 3 elementy.

integer

W przypadku menu wielokrotnego wyboru liczba znaków, które użytkownik wpisze, zanim aplikacja wyśle zapytanie do użytkownika, jest uzupełniana automatycznie i wyświetla sugerowane elementy w menu.

Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość 0 w przypadku źródeł danych statycznych i 3 w przypadku źródeł danych zewnętrznych.

object (Validation)

W przypadku menu rozwijanych weryfikacja tego pola wyboru.

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

object (Action)

Zewnętrzne źródło danych, takie jak relacyjna baza danych.

object (PlatformDataSource)

Źródło danych z Google Workspace.

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

string

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

string

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

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

boolean

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

string

W przypadku menu wielokrotnego wyboru adres URL ikony wyświetlanej obok elementu text . Obsługuje pliki PNG i JPEG. Musi to być format: HTTPS Adres URL. Przykład: https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png

string

w przypadku menu wielokrotnego wyboru – opis tekstowy lub etykieta wyświetlana pod nagłówkiem text .

{

  // Union field data_source can be only one of the following:
  "commonDataSource": enum (CommonDataSource),
  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
  // End of list of possible types for union field data_source.
}

enum (CommonDataSource)

Źródło danych współdzielone przez wszystkie aplikacje Google Workspace, takie jak użytkownicy w organizacji Google Workspace.

object (HostAppDataSourceMarkup)

Źródło danych unikalne dla aplikacji hosta Google Workspace, takie 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: Zainstaluj biblioteki klienta.

{

  // Union field data_source can be only one of the following:
  "chatDataSource": {
    object (ChatClientDataSourceMarkup)
  }
  // End of list of possible types for union field data_source.
}

object (ChatClientDataSourceMarkup)

Źródło danych z Google Chat.

{

  // Union field source can be only one of the following:
  "spaceDataSource": {
    object (SpaceDataSource)
  }
  // End of list of possible types for union field source.
}

object (SpaceDataSource)

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

{
  "defaultToCurrentSpace": boolean
}

boolean

Jeśli jest ustawiona na true, w menu wielokrotnego wyboru domyślnie występuje obecny pokój Google Chat.

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

string

Nazwa, według której DateTimePicker jest wykrywany w zdarzeniu danych wejściowych formularza.

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

string

Tekst, który prosi użytkowników o podanie 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 umożliwia wpisywanie daty, godziny lub daty i godziny.

string (int64 format)

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

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

• DATE_AND_TIME : data i godzina w kalendarzu w czasie UTC. Aby na przykład podać datę 1 stycznia 2023 r. o 12:00 czasu UTC, użyj ciągu 1672574400000
• DATE_ONLY : dzień kalendarzowy o godzinie 00:00:00 czasu UTC. Na przykład do określenia daty 1 stycznia 2023 r. wpisz 1672531200000
• TIME_ONLY : czas w strefie czasowej UTC. Na przykład aby podać godzinę 12:00, użyj wartości 43200000 (lub 12 * 60 * 60 * 1000).

integer

Liczba reprezentująca przesunięcie strefy czasowej względem UTC w minutach. Jeśli jest ustawiona, valueMsEpochwyświetla się 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 reklamę. Zapisz lub Wyczyść z DateTimePicker za pomocą prostego interfejsu online.

object (Validation)

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

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

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. Zależy ona od tego, gdzie wyświetla się siatka (dialog czy reklama towarzysząca).

object (OnClick)

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

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

string

Określony przez użytkownika identyfikator tego elementu siatki. Ten identyfikator jest zwracany w siatce nadrzędnej onClick parametrów wywołania zwrotnego.

object (ImageComponent)

Obraz wyświetlany w elemencie siatki.

string

Tytuł elementu siatki.

string

Podtytuł elementu siatki.

enum (GridItemLayout)

Układ do użycia w elemencie siatki.

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

string

Adres URL obrazu.

string

Etykieta ułatwień dostępu do 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

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

Na przykład w ten sposób możesz 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, które mają być używane, gdy typ to BORDER_TYPE_STROKE

Aby ustawić kolor kreski, podaj wartość 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 ten kod ustawia kolor czerwony z maksymalną intensywnością:

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

alpha pole jest niedostępne dla koloru kreski. Jeśli pole jest określone, jest ignorowane.

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ą się znajdować na górze, na dole czy na środku kolumny.

object (Widgets)

Tablica widżetów 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)
  },
  "chipList": {
    object (ChipList)
  }
  // End of list of possible types for union field data.
}

object (TextParagraph)

TextParagraph widżet.

object (Image)

Widżet Image.

object (DecoratedText)

DecoratedText widżet.

object (ButtonList)

ButtonList widżet.

object (TextInput)

Widżet TextInput.

object (SelectionInput)

SelectionInput widżet.

object (DateTimePicker)

DateTimePicker widżet.

object (ChipList)

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

{
  "layout": enum (Layout),
  "chips": [
    {
      object (Chip)
    }
  ]
}

enum (Layout)

Określony układ listy elementów.

object (Chip)

Tablica elementów.

{
  "icon": {
    object (Icon)
  },
  "label": string,
  "onClick": {
    object (OnClick)
  },
  "enabled": boolean,
  "disabled": boolean,
  "altText": string
}

object (Icon)

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

string

Tekst wyświetlany w elemencie.

object (OnClick)

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

boolean

Czy element jest aktywny i reaguje na działania użytkownika. Domyślna wartość to true. Rola wycofana. Używaj 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 opis, który poinformuje 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 deweloperów Google Chat na stronie https://developers.google.com/workspace/chat".

{
  "horizontalAlignment": enum (HorizontalAlignment),
  "expandButton": {
    object (Button)
  },
  "collapseButton": {
    object (Button)
  }
}

enum (HorizontalAlignment)

Wyrównanie w poziomie przycisku rozwijania i zwijania.

object (Button)

Opcjonalnie: Zdefiniuj przycisk konfigurowalny, aby rozwinąć tę sekcję. Należy ustawić wartości w polach „expandButton” i „ZwińButton). Tylko jedno ustawienie pola nie będzie działać. Jeśli to pole nie jest skonfigurowane, używany jest przycisk domyślny.

object (Button)

Opcjonalnie: Zdefiniuj przycisk konfigurowalny, który zwija sekcję. Należy ustawić wartości w polach „expandButton” i „ZwińButton). Tylko jedno ustawienie pola nie będzie działać. Jeśli to pole nie jest skonfigurowane, używany jest przycisk domyślny.

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

string

Etykieta wyświetlana jako element menu czynności.

object (OnClick)

onClickDziałanie związane z tym elementem czynności.

{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  }
}

object (Button)

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

object (Button)

Przycisk drugiego przycisku stałej stopki. Przycisk musi być przyciskiem tekstowym z ustawionym tekstem i kolorem. Jeśli secondaryButton jest ustawiony, musisz też primaryButton