Icon

Biểu tượng xuất hiện trong một tiện ích trên thẻ. Để xem ví dụ về các ứng dụng Google Chat, hãy xem phần Thêm biểu tượng.

Hỗ trợ biểu tượng tích hợp sẵn và biểu tượng tuỳ chỉnh.

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

Biểu diễn dưới dạng JSON 
{
  "altText": string,
  "imageType": enum (ImageType),

  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
}
Trường
altText

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, giá trị mặc định Button sẽ được cung cấp. Tốt nhất là bạn nên đặt nội dung 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, thì altText sẽ 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.
imageType

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 thao tác cắt CIRCLE sẽ khiến hình ảnh được vẽ lớn hơn biểu tượng tích hợp sẵn.
Biểu tượng hiển thị trong tiện ích trên thẻ. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
knownIcon

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 chỉ định BUS.

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

string

Hiển thị biểu tượng tuỳ chỉnh được lưu trữ tại một 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.
materialIcon

object (MaterialIcon)

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

Ví dụ: để hiển thị biểu tượng hộp đánh dấu, hãy sử dụng

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

Có thể dùng cho các ứng dụng Google Chat và không thể dùng cho các tiện ích bổ sung của Google Workspace.
Kết thúc các trường loại trừ lẫn nhau.

MaterialIcon

Biểu tượng Material của Google, bao gồm hơn 2.500 lựa chọn.

Ví dụ: để hiển thị biểu tượng hộp đánh dấu có độ đậm và cấp độ tuỳ chỉnh, hãy viết như sau:

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

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

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
Trường
name

string

Tên biểu tượng được xác định trong Biểu tượng Material của Google, 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, dẫn đến việc biểu tượng không hiển thị được.
fill

boolean

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

Để xem trước các chế độ cài đặt biểu tượng, hãy chuyển đến Google Fonts rồi điều chỉnh chế độ cài đặt trong phần Tuỳ chỉnh.
weight

integer

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

Để xem trước các chế độ cài đặt biểu tượng, hãy chuyển đến Google Fonts rồi điều chỉnh chế độ cài đặt trong phần Tuỳ chỉnh.
grade

integer

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

Để xem trước các chế độ cài đặt biểu tượng, hãy chuyển đến Google Fonts rồi điều chỉnh chế độ cài đặt trong phần Tuỳ chỉnh.