Hướng dẫn google script read spreadsheet data - tập lệnh google đọc dữ liệu bảng tính

Bảng tính có thể có nhiều tờ, với mỗi tờ có bất kỳ số lượng hàng hoặc cột nào. Một ô là một vị trí tại giao điểm của một hàng và cột cụ thể và có thể chứa giá trị dữ liệu. API Google Sheets cung cấp bộ sưu tập bảng tính.

Trang này mô tả những điều cơ bản của việc sử dụng bộ sưu tập bảng tính.values. Nếu bạn cần cập nhật định dạng hoặc các thuộc tính khác trong một tờ, bạn sẽ cần sử dụng bộ sưu tập bảng tính, được mô tả trong việc cập nhật bảng tính.

Phương pháp

Bộ sưu tập bảng tính.values ​​cung cấp các phương pháp sau để đọc và ghi giá trị, mỗi phương pháp có một nhiệm vụ cụ thể trong tâm trí:

Nói chung, bạn nên kết hợp nhiều lần đọc hoặc cập nhật với các phương thức Batchget và BatchupDate [tương ứng], vì điều này sẽ cải thiện hiệu quả.

Bạn có thể tìm thấy các ví dụ về từng phương pháp này trong các trang mẫu đọc cơ bản và cơ bản.

Đọc

Viết

Nói chung, bạn nên kết hợp nhiều lần đọc hoặc cập nhật với các phương thức Batchget và BatchupDate [tương ứng], vì điều này sẽ cải thiện hiệu quả.

Bạn có thể tìm thấy các ví dụ về từng phương pháp này trong các trang mẫu đọc cơ bản và cơ bản.

Để đọc dữ liệu từ một tờ, bạn sẽ cần ID bảng tính và ký hiệu A1 phạm vi. Để biết thêm thông tin về ID bảng tính và ký hiệu A1, hãy xem các khái niệm chính trong API Google Sheets. Định dạng của đầu ra được điều khiển bởi ba tham số tùy chọn:

Tham số định dạng

SỐ SERI

Lưu ý rằng dateTimeRenderOption chỉ được sử dụng nếu valueRenderOption không phải là FORMATTED_VALUE.

Các phương pháp số ít và lô được mô tả dưới đây. Để biết ví dụ về các hoạt động đọc cơ bản, hãy xem trang Công thức đọc cơ bản.

SỐ SERI

Viết

Phạm vi đơn

bảng tính.values.get

Nói chung, bạn nên kết hợp nhiều lần đọc hoặc cập nhật với các phương thức Batchget và BatchupDate [tương ứng], vì điều này sẽ cải thiện hiệu quả.

Bạn có thể tìm thấy các ví dụ về từng phương pháp này trong các trang mẫu đọc cơ bản và cơ bản.

Để đọc dữ liệu từ một tờ, bạn sẽ cần ID bảng tính và ký hiệu A1 phạm vi. Để biết thêm thông tin về ID bảng tính và ký hiệu A1, hãy xem các khái niệm chính trong API Google Sheets. Định dạng của đầu ra được điều khiển bởi ba tham số tùy chọn:

SỐ SERI

Lưu ý rằng dateTimeRenderOption chỉ được sử dụng nếu valueRenderOption không phải là FORMATTED_VALUE.

Các phương pháp số ít và lô được mô tả dưới đây. Để biết ví dụ về các hoạt động đọc cơ bản, hãy xem trang Công thức đọc cơ bản.

Đọc một phạm vi duy nhất

SỐ SERI

Nối thêm các giá trị

Để nối dữ liệu sau một bảng dữ liệu trong một tờ, hãy sử dụng bảng tính.

Phần thân của yêu cầu cập nhật phải là một đối tượng định giá, mặc dù trường duy nhất được yêu cầu là values. Nếu range được chỉ định, nó phải khớp với phạm vi trong URL. Trong Valuerange, bạn có thể tùy ý chỉ định Majordimension của nó. Theo mặc định, hàng được sử dụng. Nếu các cột được chỉ định, mỗi mảng bên trong được ghi vào một cột thay vì một hàng.

Phạm vi đầu vào được sử dụng để tìm kiếm dữ liệu hiện có và tìm một "bảng" trong phạm vi đó. Các giá trị được gắn vào hàng tiếp theo của bảng, bắt đầu với cột đầu tiên của bảng. Ví dụ, hãy xem xét một tờ valueRenderOption2 trông giống như:

Có hai bảng trong trang tính: valueRenderOption3 và valueRenderOption4. Các giá trị được thêm vào sẽ bắt đầu tại valueRenderOption5 cho tất cả các đầu vào range sau:

• valueRenderOption2, vì nó sẽ kiểm tra tất cả dữ liệu trong trang tính, xác định rằng bảng tại valueRenderOption4 là bảng cuối cùng.
• valueRenderOption9 hoặc FORMATTED_VALUE0, bởi vì cả hai đều nằm trong bảng valueRenderOption4.
• FORMATTED_VALUE2, vì bảng cuối cùng trong phạm vi là bảng valueRenderOption4 [mặc dù nó cũng chứa bảng valueRenderOption3].
• FORMATTED_VALUE5, vì bảng cuối cùng trong phạm vi là bảng valueRenderOption4 [mặc dù bắt đầu trước và kết thúc sau khi nó].

Các đầu vào range sau đây sẽ không bắt đầu viết tại valueRenderOption5:

• FORMATTED_VALUE9 sẽ bắt đầu viết vào lúc RAW0, bởi vì đó là trong bảng valueRenderOption3.
• RAW2 sẽ bắt đầu viết tại RAW2, bởi vì nó không có trong bất kỳ bảng nào. [RAW4 cũng sẽ bắt đầu viết tại RAW4 vì những lý do tương tự.]

Ngoài ra, bạn có thể chọn nếu bạn muốn ghi đè dữ liệu hiện có sau một bảng hoặc chèn các hàng mới cho dữ liệu mới. Theo mặc định, đầu vào ghi đè dữ liệu sau bảng. Để viết dữ liệu mới vào các hàng mới, chỉ định RAW6.

Để tìm hiểu thêm về giới hạn ô và hàng trong Google Sheets, hãy xem các tệp bạn có thể lưu trữ trong Google Drive.