Khối thông minh

Hướng dẫn này mô tả cách thức và lý do sử dụng Google Sheets API để 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 dữ liệu thông minh, bạn có thể đưa dữ liệu phong phú, có tính tương tác từ các ứng dụng khác của Google Workspace vào Trang tính. Chip thông minh giúp người dùng truy cập nhanh vào thông tin và thao tác, chuyển đổi một đường liên kết đến ô 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 khối chạy, là một phần của CellData, vì vậy, bạn có thể chèn một khối bằ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 có 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 một userEnteredValue chứa các ký tự giữ chỗ (@) cho từng chip mà bạn dự đị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 có chip khi ghi.

Ví dụ sau đây cho biết cách ghi một chip tệp, một chip người dùng 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 các thuộc tính khối

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

personProperties

Dùng phương thức này để tạo một 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 đó. Có thể là một trong những trạng thái sau đây:
    • DEFAULT: Định dạng "Họ Tên" tiêu chuẩn.
    • LAST_NAME_COMMA_FIRST_NAME: Định dạng "Họ, Tên".
    • EMAIL: Địa chỉ email của người đó.

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

  • uri: (Bắt buộc) URI của tài nguyên. Đối với bài viết, đâ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 một khối thông minh, hãy sử dụng phương thức spreadsheets.get và thêm sheets.data.rowData.values(chipRuns) vào tham số fields.

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

  • Đường chạy có gắn chip: Các phần này sẽ có một đối tượng chip chứa personProperties hoặc richLinkProperties.
  • Đoạn văn bản không có chip: Các đoạn văn bản thuần tuý cũng sẽ có một đối tượng đoạn văn bản, 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 thông tin, 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ế một 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 bạn thêm một chip, cung cấp userEnteredValue và chipRun mới. Thao tác này sẽ thay thế thành phần 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 thông minh cho người dùng) hoặc các tài liệu liên quan (Khối thông minh cho 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 các chip thông minh trong dải ô đó.