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)

Tiêu đề của thẻ. Tiêu đề thường chứa hình ảnh ở đầu và tiêu đề. Tiêu đề luôn xuất hiện ở đầu thẻ.

object (Section)

Chứa một bộ sưu tập tiện ích. Mỗi phần có tiêu đề riêng (không bắt buộc). Các phần được phân tách trực quan bằng đường phân cách dòng. Để xem ví dụ trong các ứng dụng Google Chat, hãy xem Xác định một mục của thẻ.

enum (DividerStyle)

Kiểu phân cách giữa các phần.

object (CardAction)

Hành động của thẻ. Các thao tác sẽ được thêm vào trình đơn trên thanh công cụ của thẻ.

Dùng được đối với các tiện ích bổ sung của Google Workspace và không dùng được trong ứng dụng Google Chat.

Ví dụ: tệp JSON sau đây tạo một trình đơn thao tác đối với thẻ có Settings và Send Feedback tùy chọn:

"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

Tên thẻ. Được dùng làm giá trị nhận dạng thẻ trong phần điều hướng thẻ.

Dùng được đối với các tiện ích bổ sung của Google Workspace và không dùng được trong ứng dụng Google Chat.

object (CardFixedFooter)

Chân trang cố định hiển thị ở cuối thẻ này.

Chế độ cài đặt fixedFooter mà không chỉ định primaryButton hoặc secondaryButton gây ra lỗi. Đối với các ứng dụng trong Chat, bạn có thể sử dụng chân trang cố định trong hộp thoại, nhưng không bao gồm thông báo thẻ.

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

enum (DisplayStyle)

Trong Tiện ích bổ sung của Google Workspace, hãy đặt các thuộc tính hiển thị của peekCardHeader.

Dùng được đối với các tiện ích bổ sung của Google Workspace và không dùng được trong ứng dụng Google Chat.

object (CardHeader)

Khi hiển thị nội dung theo ngữ cảnh, tiêu đề của thẻ xem trước hoạt động như một phần giữ chỗ để người dùng có thể di chuyển tiếp giữa các thẻ trang chủ và thẻ theo bối cảnh.

Dùng được đối với các tiện ích bổ sung của Google Workspace và không dùng được trong ứng dụng Google Chat.

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

string

Bắt buộc. Tiêu đề của tiêu đề thẻ. Tiêu đề có chiều cao cố định: nếu cả tiêu đề và phụ đề được chỉ định thì mỗi tiêu đề sẽ chiếm một dòng. Nếu chỉ có tiêu đề được chỉ định, thì tiêu đề sẽ chiếm cả hai dòng.

string

Phụ đề của tiêu đề thẻ. Nếu được chỉ định, sẽ xuất hiện trên dòng riêng bên dưới dòng title.

enum (ImageType)

Hình dạng dùng để cắt hình ảnh.

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

string

URL loại HTTPS của hình ảnh trong tiêu đề thẻ.

string

Văn bản thay thế của hình ảnh này dùng cho việc hỗ trợ tiếp cận.

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

string

Văn bản xuất hiện ở đầu một mục. Hỗ trợ văn bản có định dạng HTML đơn giản. Để biết thêm thông tin về cách định dạng văn bản, hãy xem bài viết Định dạng văn bản trong ứng dụng Google Chat và Định dạng văn bản trong tiện ích bổ sung của Google Workspace.

object (Widget)

Tất cả tiện ích trong phần này. Phải chứa ít nhất một tiện ích.

boolean

Cho biết liệu mục này có thể thu gọn hay không.

Các phần có thể thu gọn sẽ ẩn một số hoặc tất cả tiện ích, nhưng người dùng có thể mở rộng phần này để hiển thị các tiện ích bị ẩn bằng cách nhấp vào Hiện thêm. Người dùng có thể ẩn các tiện ích một lần nữa bằng cách nhấp vào Ẩn bớt.

Để xác định tiện ích nào bị ẩn, hãy chỉ định uncollapsibleWidgetsCount.

integer

Số lượng tiện ích không thể thu gọn vẫn hiển thị ngay cả khi thu gọn một phần.

Ví dụ: khi một phần chứa 5 tiện ích và uncollapsibleWidgetsCount được đặt thành 2, thì 2 tiện ích đầu tiên luôn hiển thị và 3 tiện ích cuối cùng sẽ được thu gọn theo mặc định. Chiến lược phát hành đĩa đơn uncollapsibleWidgetsCount chỉ được tính khi collapsible là true.

object (CollapseControl)

Không bắt buộc. Xác định nút mở rộng và thu gọn của phần. Nút này sẽ chỉ hiển thị nếu phần đó có thể thu gọn. Nếu bạn không đặt trường này, nút mặc định sẽ được sử dụng. Dùng được trên ứng dụng Google Chat và không dùng được với Tiện ích bổ sung của 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)

Chỉ định xem các tiện ích căn chỉnh sang trái, phải hay giữa cột.

object (TextParagraph)

Hiển thị một đoạn văn bản. Hỗ trợ văn bản có định dạng HTML đơn giản. Để biết thêm thông tin về cách định dạng văn bản, hãy xem Định dạng văn bản trong các ứng dụng Google Chat và Định dạng văn bản trong Tiện ích bổ sung của Google Workspace.

Ví dụ: JSON sau đây sẽ tạo văn bản in đậm:

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

object (Image)

Hiển thị hình ảnh.

Ví dụ: JSON sau đây tạo một hình ảnh có văn bản thay thế:

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

object (DecoratedText)

Hiện một mục văn bản được trang trí.

Ví dụ: tệp JSON sau đây tạo một tiện ích văn bản được trang trí và hiển thị địa chỉ email:

"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)

Danh sách các nút.

Ví dụ: JSON sau đây tạo hai nút. Nút đầu tiên là nút văn bản màu xanh dương và nút thứ hai là nút hình ảnh mở đường liên kết:

"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)

Hiển thị hộp văn bản mà người dùng có thể nhập vào.

Ví dụ: tệp JSON sau đây tạo một mục nhập văn bản cho một địa chỉ email:

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

Một ví dụ khác: JSON sau đây tạo một mục nhập văn bản cho một ngôn ngữ lập trình với các đề xuất tĩnh:

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

object (SelectionInput)

Hiển thị một thành phần điều khiển lựa chọn cho phép người dùng chọn các mục. Thành phần điều khiển lựa chọn có thể là hộp đánh dấu, nút chọn, nút chuyển hoặc trình đơn thả xuống.

Ví dụ: JSON sau đây tạo một trình đơn thả xuống cho phép người dùng chọn kích thước:

"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)

Hiển thị tiện ích cho phép người dùng nhập ngày, giờ hoặc ngày và giờ.

Ví dụ: tệp JSON sau đây tạo một bộ chọn ngày giờ để lên lịch một cuộc hẹn:

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

object (Divider)

Hiện đường phân chia đường ngang giữa các tiện ích.

Ví dụ: JSON sau đây tạo một bộ chia:

"divider": {
}

object (Grid)

Hiển thị lưới có một tập hợp các mục.

Lưới hỗ trợ số lượng cột và mục bất kỳ. Số hàng được xác định bằng giới hạn trên của các mục số chia cho số cột. Một lưới gồm 10 mục và 2 cột sẽ có 5 hàng. Một lưới gồm 11 mục và 2 cột sẽ có 6 hàng.

Có sẵn cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

Ví dụ: JSON sau đây tạo một lưới gồm 2 cột chứa một mục duy nhất:

"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)

Hiện tối đa 2 cột.

Để đưa vào nhiều hơn 2 cột hoặc để sử dụng hàng, hãy sử dụng Grid tiện ích.

Ví dụ: tệp JSON sau đây tạo 2 cột, mỗi cột chứa các đoạn văn bản:

"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)

Danh sách khối.

Ví dụ: tệp JSON sau đây tạo ra hai khối. Đầu tiên là khối văn bản và khối thứ hai là khối biểu tượng mở ra một đường liên kết:

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

Dùng được trên ứng dụng Google Chat và không dùng được với Tiện ích bổ sung của Google Workspace.

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

string

Văn bản hiển thị trong tiện ích.

integer

Số dòng văn bản tối đa được hiển thị trong tiện ích. Nếu văn bản vượt quá số dòng tối đa đã chỉ định, thì nội dung vượt quá sẽ bị che khuất sau hiện thêm . Nếu văn bản bằng hoặc ngắn hơn số dòng tối đa được chỉ định, hiện thêm không được hiển thị.

Giá trị mặc định là 0, trong trường hợp này, tất cả ngữ cảnh sẽ hiển thị. Bỏ qua các giá trị âm. Có sẵn cho các ứng dụng Google Chat và không có sẵn cho các tiện ích bổ sung của Google Workspace.

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

string

URL loại HTTPS lưu trữ hình ảnh.

Ví dụ:

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

object (OnClick)

Khi người dùng nhấp vào hình ảnh, lượt nhấp đó sẽ kích hoạt hành động này.

string

Văn bản thay thế của hình ảnh này dùng cho việc hỗ trợ tiếp cận.

{

  // 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)

Nếu được chỉ định, một hành động sẽ được kích hoạt bởi trình đơn này onClick.

object (OpenLink)

Nếu được chỉ định, onClick kích hoạt hành động liên kết mở.

object (Action)

Tiện ích bổ sung sẽ kích hoạt hành động này khi hành động cần mở một đường liên kết. Điều này khác với openLink ở trên, trong đó tác vụ này cần giao tiếp với máy chủ để nhận liên kết. Do đó, ứng dụng web cần thực hiện một số công việc chuẩn bị trước khi phản hồi hành động mở đường liên kết được trả về.

Dùng được đối với các tiện ích bổ sung của Google Workspace và không dùng được trong ứng dụng Google Chat.

object (Card)

Một thẻ mới sẽ được đẩy vào ngăn xếp thẻ sau khi nhấp vào nếu được chỉ định.

Có sẵn cho các tiện ích bổ sung của Google Workspace và không có sẵn cho các ứng dụng Google Chat.

object (OverflowMenu)

Nếu được chỉ định, onClick mở ra một trình đơn mục bổ sung. Dùng được trên ứng dụng Google Chat và không dùng được với Tiện ích bổ sung của Google Workspace.

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

string

Một hàm tuỳ chỉnh để gọi khi phần tử chứa được nhấp vào hoặc được kích hoạt.

Để biết ví dụ về cách sử dụng, hãy xem phần Đọc dữ liệu biểu mẫu.

object (ActionParameter)

Danh sách thông số hành động.

enum (LoadIndicator)

Chỉ định chỉ báo tải mà hành động hiển thị trong khi thực hiện lệnh gọi hành động.

boolean

Cho biết liệu giá trị của biểu mẫu có còn sau thao tác này hay không. Giá trị mặc định là false.

Nếu true, các giá trị của biểu mẫu sẽ vẫn tồn tại sau khi bạn kích hoạt hành động. Để cho phép người dùng thực hiện thay đổi trong khi hành động đang được xử lý, hãy đặt LoadIndicator đến NONE. Để thông báo thẻ trong ứng dụng Chat, bạn cũng phải đặt ResponseType đến UPDATE_MESSAGE và sử dụng cùng một cardId từ thẻ chứa hành động đó.

Nếu false, các giá trị biểu mẫu sẽ bị xoá khi hành động được kích hoạt. Để ngăn người dùng thực hiện thay đổi trong khi hành động đang được xử lý, hãy đặt LoadIndicator đến SPINNER.

enum (Interaction)

Không bắt buộc. Bắt buộc khi mở hộp thoại.

Việc cần làm để phản hồi lại một lượt tương tác với người dùng, chẳng hạn như khi người dùng nhấp vào một nút trong thông báo thẻ.

Nếu không được chỉ định, ứng dụng sẽ phản hồi bằng cách thực thi một action – chẳng hạn như mở đường liên kết hoặc chạy một hàm – như bình thường.

Bằng cách chỉ định một interaction, ứng dụng có thể phản hồi theo những cách tương tác đặc biệt. Ví dụ: bằng cách đặt interaction đến OPEN_DIALOG, ứng dụng này có thể mở một hộp thoại. Khi được chỉ định, chỉ báo tải sẽ không hiển thị. Nếu bạn chỉ định cho một tiện ích bổ sung, thì toàn bộ thẻ sẽ bị xoá và không có nội dung nào hiển thị trong ứng dụng.

Dùng được trên ứng dụng Google Chat và không dùng được với Tiện ích bổ sung của Google Workspace.

string

Nếu các tiện ích được liệt kê ở đây không có giá trị khi Hành động này được gọi, thì quá trình gửi biểu mẫu sẽ bị huỷ.

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

boolean

Có sẵn cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

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

string

Tên của thông số cho tập lệnh hành động.

string

Giá trị của thông số.

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

string

URL cần mở.

enum (OpenAs)

Cách mở đường liên kết.

Có sẵn cho các tiện ích bổ sung của Google Workspace và không có sẵn cho các ứng dụng Google Chat.

enum (OnClose)

Liệu ứng dụng có quên một đường liên kết sau khi mở hay quan sát đường liên kết đó cho đến khi cửa sổ đóng lại hay không.

Dùng được đối với các tiện ích bổ sung của Google Workspace và không dùng được trong ứng dụng Google Chat.

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

object (OverflowMenuItem)

Bắt buộc. Danh sách các lựa chọn trên trình đơn.

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

object (Icon)

Biểu tượng xuất hiện ở phía trước văn bản.

string

Bắt buộc. Văn bản giúp xác định hoặc mô tả mặt hàng cho người dùng.

object (OnClick)

Bắt buộc. Hành động được gọi khi một lựa chọn trong trình đơn được chọn. Chiến dịch này OnClick không được chứa một OverflowMenu, bất kỳ giá trị nào được chỉ định OverflowMenu bị thả và mục trong trình đơn bị tắt.

boolean

Liệu tuỳ chọn trình đơn có bị tắt hay không. Giá trị mặc định là false.

{
  "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

Không bắt buộc. Nội dung mô tả biểu tượng dùng cho tính năng hỗ trợ tiếp cận. Nếu bạn không chỉ định, hệ thống sẽ cung cấp giá trị mặc định là Button. Tốt nhất là bạn nên đặt một đoạn mô tả hữu ích cho nội dung mà biểu tượng hiển thị và chức năng của biểu tượng (nếu có). Ví dụ: A user's account portrait hoặc Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat.

Nếu biểu tượng được đặt trong Button, altText xuất hiện dưới dạng văn bản trợ giúp khi người dùng di chuột qua nút. Tuy nhiên, nếu nút cũng đặt text, thì altText của biểu tượng sẽ bị bỏ qua.

enum (ImageType)

Kiểu cắt được áp dụng cho hình ảnh. Trong một số trường hợp, việc áp dụng CIRCLE cắt khiến hình ảnh bị vẽ lớn hơn biểu tượng tích hợp sẵn.

string

Hiển thị một trong các biểu tượng tích hợp sẵn do Google Workspace cung cấp.

Ví dụ: để hiển thị biểu tượng máy bay, hãy chỉ định AIRPLANE. Đối với xe buýt, hãy nêu rõ BUS.

Để xem danh sách đầy đủ các biểu tượng được hỗ trợ, hãy xem biểu tượng tích hợp sẵn.

string

Hiển thị biểu tượng tuỳ chỉnh được lưu trữ trong URL loại HTTPS.

Ví dụ:

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

Các loại tệp được hỗ trợ bao gồm .png và .jpg.

object (MaterialIcon)

Hiển thị một trong Biểu tượng Google Material.

Ví dụ: để hiển thị biểu tượng hộp kiểm, sử dụng

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

Dùng được trên ứng dụng Google Chat và không dùng được với Tiện ích bổ sung của Google Workspace.

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

string

Tên biểu tượng được xác định trong Biểu tượng Google Material, ví dụ: check_box. Mọi tên không hợp lệ đều bị bỏ qua và thay thế bằng chuỗi trống, khiến biểu tượng không hiển thị.

boolean

Liệu biểu tượng có hiển thị là đã tô màu nền hay không. Giá trị mặc định là sai.

Để xem trước các chế độ cài đặt biểu tượng khác nhau, hãy chuyển đến Biểu tượng phông chữ của Google và điều chỉnh cài đặt trong Tuỳ chỉnh.

integer

Độ đậm nét của biểu tượng. Chọn từ {100, 200, 300, 400, 500, 600, 700}. Nếu không có, giá trị mặc định sẽ là 400. Nếu có bất kỳ giá trị nào khác được chỉ định, thì giá trị mặc định sẽ được sử dụng.

Để xem trước các chế độ cài đặt biểu tượng khác nhau, hãy chuyển đến Biểu tượng phông chữ của Google và điều chỉnh cài đặt trong Tuỳ chỉnh.

integer

Trọng số và cấp độ ảnh hưởng đến độ dày của biểu tượng. Hệ số điều chỉnh điểm sẽ chi tiết hơn hệ số điều chỉnh trọng số và có tác động nhỏ đến kích thước của ký hiệu. Chọn từ {-25, 0, 200}. Nếu không có, giá trị mặc định là 0. Nếu bạn chỉ định giá trị nào khác, giá trị mặc định sẽ được sử dụng.

Để xem trước các chế độ cài đặt biểu tượng khác nhau, hãy chuyển đến Biểu tượng phông chữ của Google và điều chỉnh cài đặt trong Tuỳ chỉnh.

{
  "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)

Không dùng nữa, thay vào đó startIcon.

object (Icon)

Biểu tượng xuất hiện ở phía trước văn bản.

string

Văn bản xuất hiện phía trên text. Luôn cắt ngắn.

string

Bắt buộc. Văn bản chính.

Hỗ trợ định dạng đơn giản. Để biết thêm thông tin về cách định dạng văn bản, hãy xem Định dạng văn bản trong các ứng dụng Google Chat và Định dạng văn bản trong Tiện ích bổ sung của Google Workspace.

boolean

Chế độ cài đặt xuống dòng tự động. Nếu true, văn bản được gói và hiển thị trên nhiều dòng. Nếu không, văn bản sẽ bị cắt bớt.

Chỉ áp dụng cho text, không topLabel và bottomLabel.

string

Văn bản xuất hiện bên dưới text. Luôn kết thúc.

object (OnClick)

Thao tác này được kích hoạt khi người dùng nhấp vào topLabel hoặc bottomLabel.

object (Button)

Một nút mà người dùng có thể nhấp vào để kích hoạt một hành động.

object (SwitchControl)

Một tiện ích nút chuyển mà người dùng có thể nhấp vào để thay đổi trạng thái và kích hoạt một hành động.

object (Icon)

Một biểu tượng xuất hiện sau văn bản.

Hỗ trợ tích hợp sẵn và tuỳ chỉnh .

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

string

Văn bản xuất hiện bên trong nút.

object (Icon)

Một biểu tượng xuất hiện bên trong nút. Nếu cả hai icon và text đặt, thì biểu tượng này sẽ xuất hiện trước văn bản.

object (Color)

Không bắt buộc. Màu của nút. Nếu được đặt, nút này type được đặt thành FILLED và màu của text và icon các trường được đặt thành màu tương phản để dễ đọc. Ví dụ: nếu màu của nút được đặt thành màu xanh dương, thì mọi văn bản hoặc biểu tượng trong nút đó cũng sẽ được đặt thành màu trắng.

Để đặt màu nút, hãy chỉ định giá trị cho các trường red, green và blue. Giá trị này phải là số thực từ 0 đến 1 dựa trên giá trị màu RGB, trong đó 0 (0/255) biểu thị sự không có màu sắc và 1 (255/255) biểu thị cường độ tối đa của màu.

Ví dụ: mã sau đây đặt màu thành màu đỏ ở cường độ tối đa:

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

Chiến lược phát hành đĩa đơn alpha không có trường màu nút. Nếu bạn chỉ định, trường này sẽ bị bỏ qua.

object (OnClick)

Bắt buộc. Thao tác cần thực hiện khi người dùng nhấp vào nút, chẳng hạn như mở siêu liên kết hoặc chạy hàm tuỳ chỉnh.

boolean

Nếu true, nút này hiển thị ở trạng thái không hoạt động và không phản hồi với hành động của người dùng.

string

Văn bản thay thế được dùng cho khả năng tiếp cận.

Đặt văn bản mô tả cho phép người dùng biết chức năng của nút này. Ví dụ: nếu một nút mở ra một siêu liên kết, bạn có thể viết như sau: "Mở một thẻ trình duyệt mới và điều hướng đến tài liệu dành cho nhà phát triển Google Chat tại https://developers.google.com/workspace/chat".

enum (Type)

Không bắt buộc. Loại nút. Nếu bạn không đặt chính sách này, thì loại nút sẽ đặt thành mặc định OUTLINED. Nếu color đã đặt, loại nút này buộc phải FILLED nên mọi giá trị đã đặt cho trường này đều sẽ bị bỏ qua.

Dùng được trên ứng dụng Google Chat và không dùng được với Tiện ích bổ sung của Google Workspace.

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

number

Lượng màu đỏ trong màu dưới dạng một giá trị trong khoảng [0, 1].

number

Lượng màu xanh lục trong màu dưới dạng một giá trị trong khoảng [0, 1].

number

Lượng màu xanh dương trong màu dưới dạng một giá trị trong khoảng [0, 1].

number

Tỷ lệ của màu này sẽ được áp dụng cho điểm ảnh. Tức là màu pixel cuối cùng được xác định theo phương trình:

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

Điều này có nghĩa là giá trị 1.0 tương ứng với một màu đồng nhất, trong khi giá trị 0.0 tương ứng với một màu hoàn toàn trong suốt. Phương thức này sử dụng thông báo trình bao bọc thay vì một đại lượng vô hướng float đơn giản để có thể phân biệt giữa giá trị mặc định và giá trị chưa được đặt. Nếu bạn bỏ qua, đối tượng màu này sẽ hiển thị dưới dạng một màu đồng nhất (như thể giá trị alpha đã được cung cấp rõ ràng giá trị là 1.0).

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

string

Tên dùng để xác định tiện ích nút chuyển trong một sự kiện nhập dữ liệu vào biểu mẫu.

Để biết thông tin chi tiết về cách xử lý thông tin đầu vào trong biểu mẫu, hãy xem Nhận dữ liệu biểu mẫu.

string

Giá trị do người dùng nhập, được trả về trong một sự kiện nhập dữ liệu vào biểu mẫu.

Để biết thông tin chi tiết về cách xử lý thông tin đầu vào trong biểu mẫu, hãy xem Nhận dữ liệu biểu mẫu.

boolean

Thời gian true, nút chuyển đã được chọn.

object (Action)

Hành động sẽ thực hiện khi trạng thái chuyển đổi thay đổi, chẳng hạn như hàm nào sẽ chạy.

enum (ControlType)

Cách nút chuyển xuất hiện trong giao diện người dùng.

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

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

object (Button)

Một loạt các nút.

{
  "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

Tên mà mục nhập văn bản được xác định trong một sự kiện nhập biểu mẫu.

Để biết thông tin chi tiết về cách xử lý thông tin đầu vào trong biểu mẫu, hãy xem Nhận dữ liệu biểu mẫu.

string

Văn bản xuất hiện phía trên trường nhập dữ liệu trong giao diện người dùng.

Chỉ định văn bản để giúp người dùng nhập thông tin mà ứng dụng của bạn cần. Ví dụ: nếu bạn đang hỏi tên của một người nhưng cụ thể lại cần họ của họ, hãy viết surname thay vì name.

Bắt buộc nếu hintText chưa được chỉ định. Nếu không thì không bắt buộc.

string

Văn bản xuất hiện bên dưới trường nhập văn bản nhằm hỗ trợ người dùng bằng cách nhắc họ nhập một giá trị nhất định. Văn bản này luôn hiển thị.

Bắt buộc nếu label chưa được chỉ định. Nếu không thì không bắt buộc.

string

Giá trị do người dùng nhập, được trả về trong một sự kiện nhập dữ liệu vào biểu mẫu.

Để biết thông tin chi tiết về cách xử lý thông tin đầu vào trong biểu mẫu, hãy xem Nhận dữ liệu biểu mẫu.

enum (Type)

Cách trường nhập văn bản xuất hiện trong giao diện người dùng. Ví dụ: liệu trường này là một dòng hay nhiều dòng.

object (Action)

Việc cần làm khi có thay đổi trong trường nhập văn bản. Ví dụ: người dùng thêm vào trường hoặc xoá văn bản.

Ví dụ về các hành động cần thực hiện bao gồm chạy hàm tuỳ chỉnh hoặc mở một hộp thoại trong Google Chat.

object (Suggestions)

Những giá trị được đề xuất mà người dùng có thể nhập. Các giá trị này xuất hiện khi người dùng nhấp vào bên trong trường nhập văn bản. Khi người dùng nhập, các giá trị được đề xuất sẽ lọc một cách linh động để khớp với nội dung mà người dùng đã nhập.

Ví dụ: trường nhập văn bản cho ngôn ngữ lập trình có thể đề xuất Java, JavaScript, Python và C++. Khi người dùng bắt đầu nhập Jav, danh sách đề xuất sẽ lọc để chỉ hiển thị Java và JavaScript.

Các giá trị được đề xuất giúp hướng dẫn người dùng nhập các giá trị mà ứng dụng của bạn có thể hiểu được. Khi đề cập đến JavaScript, một số người dùng có thể nhập javascript và khác java script. Việc đề xuất JavaScript có thể chuẩn hoá cách người dùng tương tác với ứng dụng của bạn.

Khi được chỉ định, TextInput.type luôn luôn SINGLE_LINE, ngay cả khi được đặt thành MULTIPLE_LINE.

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

object (Action)

Không bắt buộc. Chỉ định hành động cần thực hiện khi trường nhập văn bản cung cấp đề xuất cho người dùng tương tác với trường đó.

Nếu chưa chỉ định, các đề xuất được đặt bởi initialSuggestions và được ứng dụng xử lý.

Nếu được chỉ định, ứng dụng sẽ thực hiện thao tác nêu tại đây, chẳng hạn như chạy một hàm tuỳ chỉnh.

Dùng được đối với các tiện ích bổ sung của Google Workspace và không dùng được trong ứng dụng Google Chat.

object (Validation)

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

string

Văn bản xuất hiện trong trường nhập văn bản khi trường này trống. Sử dụng văn bản này để nhắc người dùng nhập một giá trị. Ví dụ: Enter a number from 0 to 100.

Dùng được trên ứng dụng Google Chat và không dùng được với Tiện ích bổ sung của Google Workspace.

Action

Navigation

Đẩy hoặc cập nhật thẻ được hiển thị.

Card

Ngăn xếp thẻ đẩy một thẻ vào ngăn xếp thẻ.

Card

Ngăn xếp thẻ sẽ cập nhật một thẻ mới vào thẻ trên cùng và giữ lại các giá trị của các trường trong biểu mẫu đã điền. Đối với trường không tương đương, giá trị sẽ bị loại bỏ.

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

object (SuggestionItem)

Danh sách các đề xuất được dùng cho các đề xuất tự động hoàn thành trong các trường nhập văn bản.

{

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

string

Giá trị của một trường nhập dữ liệu được đề xuất cho trường nhập dữ liệu văn bản. Nội dung này tương đương với nội dung mà người dùng tự nhập.

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

integer

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

enum (InputType)

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của 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

Bắt buộc. Tên xác định mục nhập lựa chọn trong sự kiện nhập biểu mẫu.

Để biết thông tin chi tiết về cách xử lý thông tin đầu vào trong biểu mẫu, hãy xem Nhận dữ liệu biểu mẫu.

string

Văn bản xuất hiện phía trên trường nhập dữ liệu lựa chọn trong giao diện người dùng.

Chỉ định văn bản để giúp người dùng nhập thông tin mà ứng dụng của bạn cần. Ví dụ: nếu người dùng đang chọn mức độ khẩn cấp của phiếu yêu cầu hỗ trợ trong trình đơn thả xuống, thì nhãn có thể là "Khẩn cấp" hoặc "Chọn sự khẩn cấp".

enum (SelectionType)

Loại mục mà người dùng nhìn thấy trong một SelectionInput tiện ích. Các loại lựa chọn hỗ trợ nhiều loại tương tác. Ví dụ: người dùng có thể chọn một hoặc nhiều hộp đánh dấu, nhưng chỉ có thể chọn một giá trị trong trình đơn thả xuống.

object (SelectionItem)

Một mảng các mục có thể chọn. Ví dụ: một loạt các nút chọn hoặc hộp đánh dấu. Hỗ trợ lên đến 100 mục.

object (Action)

Nếu được chỉ định, biểu mẫu sẽ được gửi khi lựa chọn thay đổi. Nếu không được chỉ định, bạn phải chỉ định một nút riêng gửi biểu mẫu.

Để biết thông tin chi tiết về cách xử lý dữ liệu đầu vào của biểu mẫu, hãy xem phần Nhận dữ liệu biểu mẫu.

integer

Đối với trình đơn đa lựa chọn, số lượng mục tối đa mà người dùng có thể chọn. Giá trị tối thiểu là 1 mục. Nếu bạn không chỉ định, giá trị mặc định sẽ là 3 mục.

integer

Đối với trình đơn chọn nhiều đối tượng, số ký tự văn bản mà người dùng nhập trước khi ứng dụng truy vấn sẽ tự động hoàn thành và hiện các mục đề xuất trong trình đơn.

Nếu bạn không chỉ định, thì mặc định sẽ là 0 ký tự đối với nguồn dữ liệu tĩnh và 3 ký tự đối với nguồn dữ liệu bên ngoài.

object (Validation)

Đối với trình đơn thả xuống, hãy xác thực trường nhập dữ liệu của lựa chọn này.

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

object (Action)

Nguồn dữ liệu bên ngoài, chẳng hạn như cơ sở dữ liệu quan hệ.

object (PlatformDataSource)

Một nguồn dữ liệu trên Google Workspace.

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

string

Văn bản giúp xác định hoặc mô tả mặt hàng cho người dùng.

string

Giá trị liên kết với mục này. Khách hàng nên sử dụng giá trị này làm giá trị nhập vào biểu mẫu.

Để biết thông tin chi tiết về cách xử lý thông tin đầu vào trong biểu mẫu, hãy xem Nhận dữ liệu biểu mẫu.

boolean

Liệu mục đó có được chọn theo mặc định hay không. Nếu mục nhập lựa chọn chỉ chấp nhận một giá trị (chẳng hạn như đối với nút chọn hoặc trình đơn thả xuống), bạn chỉ nên đặt trường này cho một mục.

string

Đối với trình đơn chọn nhiều mục, URL của biểu tượng xuất hiện bên cạnh màn hình của mục text . Hỗ trợ tệp PNG và JPEG. Phải là HTTPS URL. Ví dụ: https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.

string

Đối với trình đơn chọn nhiều mục, nội dung mô tả bằng văn bản hoặc nhãn xuất hiện bên dưới phần mở rộng của mục 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)

Một nguồn dữ liệu dùng chung cho tất cả ứng dụng của Google Workspace, chẳng hạn như người dùng trong một tổ chức trên Google Workspace.

object (HostAppDataSourceMarkup)

Một nguồn dữ liệu dành riêng cho ứng dụng lưu trữ Google Workspace, chẳng hạn như các không gian trong Google Chat.

Trường này hỗ trợ Thư viện ứng dụng API của Google nhưng không hỗ trợ Thư viện ứng dụng đám mây. Để tìm hiểu thêm, hãy xem Cài đặt thư viện ứng dụng.

{

  // 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)

Một nguồn dữ liệu của 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)

Các không gian Google Chat mà người dùng là thành viên.

{
  "defaultToCurrentSpace": boolean
}

boolean

Nếu đặt thành true, theo mặc định, trình đơn chọn nhiều mục sẽ chọn phòng Google Chat hiện tại làm mục.

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

string

Tên mà DateTimePicker được xác định trong sự kiện nhập biểu mẫu.

Để biết thông tin chi tiết về cách xử lý thông tin đầu vào trong biểu mẫu, hãy xem Nhận dữ liệu biểu mẫu.

string

Văn bản nhắc người dùng nhập ngày, giờ hoặc ngày và giờ. Ví dụ: nếu người dùng đang đặt lịch hẹn, hãy sử dụng một nhãn như Appointment date hoặc Appointment date and time.

enum (DateTimePickerType)

Tiện ích này có hỗ trợ nhập ngày, giờ hoặc ngày và giờ hay không.

string (int64 format)

Giá trị mặc định được hiển thị trong tiện ích, tính bằng mili giây kể từ Thời gian bắt đầu của hệ thống Unix.

Chỉ định giá trị dựa trên loại công cụ chọn ( DateTimePickerType):

• DATE_AND_TIME : ngày và giờ theo lịch theo giờ UTC. Ví dụ: để biểu thị ngày 1 tháng 1 năm 2023 lúc 12:00 trưa theo giờ UTC, hãy sử dụng 1672574400000.
• DATE_ONLY : một ngày dương lịch vào lúc 00:00:00 giờ UTC. Ví dụ: để thể hiện ngày 1 tháng 1 năm 2023, hãy sử dụng 1672531200000.
• TIME_ONLY : thời gian theo giờ UTC. Ví dụ: để biểu thị 12:00 trưa, hãy sử dụng 43200000 (hoặc 12 * 60 * 60 * 1000).

integer

Số biểu thị chênh lệch múi giờ so với giờ UTC, tính bằng phút. Nếu được đặt, giá trị valueMsEpoch được hiển thị theo múi giờ được chỉ định. Nếu bạn không đặt chính sách này, giá trị này sẽ được đặt mặc định thành chế độ cài đặt múi giờ của người dùng.

object (Action)

Được kích hoạt khi người dùng nhấp Lưu hoặc Xoá từ DateTimePicker .

object (Validation)

Dùng được cho các ứng dụng Google Chat và tiện ích bổ sung của Google Workspace.

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

string

Văn bản xuất hiện trong tiêu đề lưới.

object (GridItem)

Các mục để hiển thị trong lưới.

object (BorderStyle)

Kiểu đường viền áp dụng cho từng mục trong lưới.

integer

Số lượng cột cần hiển thị trong lưới. Giá trị mặc định sẽ được sử dụng nếu trường này không được chỉ định và giá trị mặc định đó sẽ khác nhau tuỳ thuộc vào vị trí hiển thị lưới (hộp thoại so với đồng hành).

object (OnClick)

Lệnh gọi lại này được từng mục riêng lẻ trong lưới sử dụng lại, nhưng với giá trị nhận dạng và chỉ mục của mục trong danh sách mặt hàng được thêm vào tham số của lệnh gọi lại.

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

string

Giá trị nhận dạng do người dùng chỉ định cho mục trong lưới này. Giá trị nhận dạng này được trả về trong onClick tham số lệnh gọi lại.

object (ImageComponent)

Hình ảnh hiển thị trong mục lưới.

string

Tiêu đề của mục trong lưới.

string

Tiêu đề phụ của mục trong lưới.

enum (GridItemLayout)

Bố cục cần sử dụng cho mục trong lưới.

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

string

URL hình ảnh.

string

Nhãn hỗ trợ tiếp cận cho hình ảnh.

object (ImageCropStyle)

Kiểu cắt sẽ áp dụng cho hình ảnh.

object (BorderStyle)

Kiểu đường viền sẽ áp dụng cho hình ảnh.

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

enum (ImageCropType)

Kiểu cắt.

number

Tỷ lệ khung hình cần sử dụng nếu loại cắt là RECTANGLE_CUSTOM.

Ví dụ: dưới đây là cách áp dụng tỷ lệ khung hình 16:9:

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

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

enum (BorderType)

Loại đường viền.

object (Color)

Màu sẽ được sử dụng khi loại BORDER_TYPE_STROKE.

Để đặt màu nét vẽ, hãy chỉ định giá trị cho red, green và blue mới. Giá trị này phải là số thực từ 0 đến 1 dựa trên giá trị màu RGB, trong đó 0 (0/255) biểu thị sự không có màu sắc và 1 (255/255) biểu thị cường độ tối đa của màu.

Ví dụ: mã sau đây đặt màu thành màu đỏ ở cường độ tối đa:

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

Chiến lược phát hành đĩa đơn alpha không có trường màu nét vẽ. Nếu bạn chỉ định, trường này sẽ bị bỏ qua.

integer

Bán kính góc của đường viền.

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

object (Column)

Một mảng cột. Bạn có thể đưa tối đa 2 cột vào một thẻ hoặc hộp thoại.

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

enum (HorizontalSizeStyle)

Chỉ định cách một cột lấp đầy chiều rộng của thẻ.

enum (HorizontalAlignment)

Chỉ định xem các tiện ích căn chỉnh sang trái, phải hay giữa cột.

enum (VerticalAlignment)

Chỉ định xem các tiện ích có căn chỉnh với đầu, cuối hay giữa cột hay không.

object (Widgets)

Một mảng tiện ích có trong một cột. Các tiện ích sẽ xuất hiện theo thứ tự được chỉ định.

{

  // 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 tiện ích.

object (Image)

Image tiện ích.

object (DecoratedText)

DecoratedText tiện ích.

object (ButtonList)

ButtonList tiện ích.

object (TextInput)

TextInput tiện ích.

object (SelectionInput)

SelectionInput tiện ích.

object (DateTimePicker)

DateTimePicker tiện ích.

object (ChipList)

ChipList tiện ích. Có sẵn cho các ứng dụng Google Chat và không có sẵn cho các tiện ích bổ sung của Google Workspace.

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

enum (Layout)

Bố cục danh sách khối được chỉ định.

object (Chip)

Một mảng chip.

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

object (Icon)

Hình ảnh biểu tượng. Nếu cả hai icon và text đặt, thì biểu tượng này sẽ xuất hiện trước văn bản.

string

Văn bản xuất hiện bên trong khối.

object (OnClick)

Không bắt buộc. Thao tác cần thực hiện khi người dùng nhấp vào khối, chẳng hạn như mở siêu liên kết hoặc chạy hàm tuỳ chỉnh.

boolean

Liệu khối này có ở trạng thái đang hoạt động và phản hồi hành động của người dùng hay không. Mặc định là true. Không dùng nữa. Thay vào đó, hãy sử dụng disabled.

boolean

Liệu khối này có ở trạng thái không hoạt động và bỏ qua các thao tác của người dùng hay không. Mặc định là false.

string

Văn bản thay thế được dùng cho khả năng tiếp cận.

Đặt văn bản mô tả cho người dùng biết chức năng của khối. Ví dụ: nếu một khối mở một siêu liên kết, hãy ghi: "Mở một thẻ trình duyệt mới và chuyển đến tài liệu dành cho nhà phát triển Google Chat tại https://developers.google.com/workspace/chat".

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

enum (HorizontalAlignment)

Căn chỉnh theo chiều ngang của nút mở rộng và thu gọn.

object (Button)

Không bắt buộc. Hãy xác định nút có thể tuỳ chỉnh để mở rộng phần này. Bạn phải đặt cả trường mở rộng nút và thu gọn nút. Chỉ một nhóm trường sẽ không có hiệu lực. Nếu bạn không đặt trường này, nút mặc định sẽ được sử dụng.

object (Button)

Không bắt buộc. Xác định nút tuỳ chỉnh để thu gọn phần đó. Bạn phải đặt cả trường expandButton và collapseButton. Chỉ một nhóm trường sẽ không có hiệu lực. Nếu bạn không đặt trường này, nút mặc định sẽ được sử dụng.

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

string

Nhãn xuất hiện dưới dạng mục trong trình đơn thao tác.

object (OnClick)

Thao tác onClick cho mục hành động này.

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

object (Button)

Nút chính của chân trang cố định. Nút đó phải là nút văn bản có văn bản và được đặt màu.

object (Button)

Nút phụ của chân trang cố định. Nút đó phải là nút văn bản có văn bản và được đặt màu. Nếu đặt secondaryButton, bạn cũng phải đặt primaryButton.