Khối thông minh

Hướng dẫn này mô tả cách thức và lý do sử dụng API Google Trang tính để thêm và quản lý khối thông minh trong bảng tính.

Khối thông minh là gì?

Với khối thông minh, bạn có thể đưa dữ liệu đa dạng thức và tương tác từ các ứng dụng khác của Google Workspace trực tiếp vào Trang tính. Khối thông minh giúp người dùng truy cập nhanh vào thông tin và thao tác, biến một đường liên kết ô thành một đối tượng động. Để tìm hiểu thêm, hãy xem bài viết Chèn khối thông minh trong Google Trang tính.

Thêm khối thông minh

Khối được biểu thị dưới dạng các lượt chạy khối, là một phần của CellData, vì vậy, bạn có thể chèn một khối bằng cách sử dụng phương thức spreadsheets.batchUpdate hiện có bằng cách cung cấp UpdateCellsRequest hoặc AppendCellsRequest.

Yêu cầu phải bao gồm trường chipRuns. Một lần chạy khối mô tả các thuộc tính của khối và vị trí của khối đó trong văn bản của ô.

Khi viết chipRuns, bạn cũng phải cung cấp userEnteredValue chứa các ký tự giữ chỗ (@) cho mỗi khối mà bạn định thêm. Mỗi lần chạy trong mảng chipRuns sẽ tương ứng với một trong các phần giữ chỗ. Bạn có thể bỏ qua các lần chạy không bị phân đoạn khi ghi.

Ví dụ sau đây cho biết cách ghi khối tệp, khối người và văn bản thuần tuý vào một ô duy nhất, A1. * {JSON}

        {
          "updateCells": {
            "rows": [
              {
                "values": [
                  {
                    "userEnteredValue": {
                      "stringValue": "@ is the owner of @."
                    },
                    "chipRuns": [
                      {
                        "chip": {
                          "personProperties": {
                            "email": "johndoe@gmail.com",
                            "displayFormat": "DEFAULT"
                          }
                        }
                      },
                      {
                        "startIndex": 18,
                        "chip": {
                          "richLinkProperties": {
                            "uri": "https://docs.google.com/document/d/YOUR_DOCUMENT_ID/edit"
                          }
                        }
                      }
                    ]
                  }
                ]
              }
            ],
            "fields": "userEnteredValue,chipRuns",
            "range": {
              "startRowIndex": 0,
              "startColumnIndex": 0
            }
          }
        }

Định cấu hình thuộc tính khối

Đối tượng khối có thể có một trong các loại thuộc tính sau:

personProperties

Sử dụng tính năng này để tạo khối người.

  • email: (Bắt buộc) Địa chỉ email của người cần liên kết.
  • displayFormat: (Không bắt buộc) Định dạng hiển thị ưu tiên cho tên của người dùng. Có thể là một trong những trạng thái sau:
    • DEFAULT: Định dạng "Tên Họ" chuẩn.
    • LAST_NAME_COMMA_FIRST_NAME: Định dạng "Họ, Tên".
    • EMAIL: Địa chỉ email của người đó.

Sử dụng thuộc tính này để tạo khối đường liên kết đa dạng thức. Mặc dù API có thể đọc các đường liên kết đến nhiều dịch vụ của Google (như YouTube hoặc Lịch), nhưng chỉ có thể ghi các đường liên kết đến tệp trên Google Drive dưới dạng khối.

  • uri: (Bắt buộc) URI của tài nguyên. Đối với tính năng ghi, đây phải là đường liên kết đến tệp trên Google Drive. URI không được vượt quá 2000 byte.

Đọc khối thông minh

Để đọc dữ liệu của khối thông minh, hãy sử dụng phương thức spreadsheets.get và đưa sheets.data.rowData.values(chipRuns) vào tham số trường.

Mảng chipRuns trong phản hồi sẽ chứa các đối tượng cho tất cả các tiểu mục của văn bản trong ô.

  • Chạy theo từng phần: Các phần này sẽ có một đối tượng chip được điền sẵn chứa personProperties hoặc richLinkProperties.
  • Các lần chạy không bị phân đoạn: Các phần văn bản thuần tuý cũng sẽ có một đối tượng chạy, nhưng trường chip của đối tượng đó sẽ trống.

Để lấy văn bản hiển thị của một khối, hãy thêm formattedValue làm trường.

Cập nhật khối thông minh

Để cập nhật hoặc thay thế khối thông minh, bạn phải ghi đè nội dung của ô. Sử dụng cùng một UpdateCellsRequest hoặc AppendCellsRequest như khi thêm một khối, cung cấp userEnteredValue và chipRun mới. Thao tác này sẽ thay thế khối hiện có trong ô.

Sử dụng khối thông minh với các tính năng khác của Trang tính

Bảng: Bạn có thể sử dụng khối thông minh làm loại cột trong bảng để theo dõi chủ sở hữu dự án (khối Danh bạ) hoặc tài liệu liên quan (khối Tệp).

Bộ lọc: Bạn có thể lọc các dải ô dựa trên giá trị văn bản của khối thông minh trong đó.