Tổng quan về API Google Trang tính
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Google Sheets API là một giao diện RESTful cho phép bạn đọc và sửa đổi dữ liệu của bảng tính. API Trang tính cho phép bạn:
- Tạo bảng tính
- Đọc và ghi các giá trị trong ô của bảng tính
- Cập nhật định dạng bảng tính
- Quản lý Trang tính liên kết
Sau đây là danh sách các thuật ngữ thường dùng trong API Trang tính:
- Bảng tính
Đối tượng chính trong Google Trang tính. Nguồn cấp dữ liệu này có thể chứa nhiều Sheets, mỗi Sheets có thông tin có cấu trúc trong Cells. Tài nguyên spreadsheets biểu thị một bảng tính. Nó chứa một giá trị spreadsheetId duy nhất.
- Mã bảng tính
- Giá trị nhận dạng riêng biệt của một bảng tính. Đây là một chuỗi cụ thể chứa các chữ cái, chữ số và một số ký tự đặc biệt tham chiếu đến một bảng tính và có thể được lấy từ URL của bảng tính đó. Mã nhận dạng bảng tính có tính ổn định, ngay cả khi tên bảng tính thay đổi.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
- Trang tính
Một trang hoặc thẻ trong bảng tính. Tài nguyên Sheets đại diện cho một trang tính. Nó chứa một giá trị sheetId bằng số duy nhất và trang tính title trong đối tượng SheetProperties.
- Mã trang tính
- Giá trị nhận dạng duy nhất của một trang cụ thể trong bảng tính. Đây là một số nguyên cụ thể chứa các số tham chiếu đến một trang tính và có thể được lấy từ URL của bảng tính. Mã trang tính có tính ổn định, ngay cả khi tên trang tính thay đổi. Để biết ví dụ, hãy xem phần Mã bảng tính.
- Ô
Một trường văn bản hoặc dữ liệu riêng lẻ trong một trang tính. Các ô được sắp xếp theo hàng và cột, đồng thời có thể được nhóm thành một dải ô. Tài nguyên Cells đại diện cho từng ô, nhưng không có giá trị mã nhận dạng duy nhất.
Thay vào đó, toạ độ hàng và cột sẽ xác định các ô.
- Ký hiệu A1
- Cú pháp dùng để xác định một ô hoặc dải ô bằng một chuỗi chứa tên trang tính, cộng với toạ độ ô bắt đầu và ô kết thúc bằng chữ cái cột và số hàng. Đây là phương thức phổ biến và hữu ích nhất khi tham chiếu đến một dải ô tuyệt đối.
Sheet1!A1:B2 đề cập đến tất cả các ô trong 2 hàng và cột đầu tiên của Trang tính 1.Sheet1!A:A đề cập đến tất cả các ô trong cột đầu tiên của Trang tính 1.Sheet1!1:2 đề cập đến tất cả các ô trong hai hàng đầu tiên của Trang tính 1.Sheet1!A5:A đề cập đến tất cả các ô của cột đầu tiên của Trang tính 1, từ hàng 5 trở đi.A1:B2 đề cập đến tất cả các ô trong hai hàng và cột đầu tiên của trang tính đầu tiên có thể nhìn thấy.Sheet1 đề cập đến tất cả các ô trong Trang tính 1.'Jon's_Data'!A1:D5 đề cập đến tất cả các ô trong 5 hàng và 4 cột đầu tiên của một trang tính có tên là "Jon's_Data".'My Custom Sheet'!A:A đề cập đến tất cả các ô trong cột đầu tiên của một trang tính có tên là "Trang tính tuỳ chỉnh của tôi".'My Custom Sheet' đề cập đến tất cả các ô trong "Trang tính tuỳ chỉnh của tôi".
Bạn phải dùng dấu nháy đơn cho tên trang có dấu cách hoặc ký tự đặc biệt.
Lưu ý: Nếu có thể, hãy sử dụng tên riêng biệt cho các đối tượng trong bảng tính. Ví dụ: A1 (không có dấu ngoặc kép) là ô A1 trong trang tính đầu tiên mà bạn nhìn thấy. 'A1' đề cập đến một trang tính có tên A1. Tương tự, Sheet1 đề cập đến một trang tính có tên là Sheet1. Tuy nhiên, nếu có một dải ô được đặt tên là "Trang tính 1", thì Trang tính 1 sẽ đề cập đến dải ô được đặt tên và 'Sheet1' sẽ đề cập đến trang tính.
- Ký hiệu R1C1
- Cú pháp dùng để xác định một ô hoặc dải ô bằng một chuỗi chứa tên trang tính cùng với toạ độ ô bắt đầu và kết thúc bằng số hàng và số cột. Phương thức này ít phổ biến hơn ký hiệu A1, nhưng có thể hữu ích khi tham chiếu đến một dải ô tương ứng với vị trí của một ô nhất định.
Sheet1!R1C1:R2C2 đề cập đến hai ô đầu tiên trong hai hàng trên cùng của Trang tính 1.R1C1:R2C2 đề cập đến 2 ô đầu tiên trong 2 hàng trên cùng của trang tính đầu tiên mà người dùng nhìn thấy.Sheet1!R[3]C[1] là ô nằm dưới ô hiện tại 3 hàng và bên phải 1 cột.
- Dải ô được đặt tên
- Một ô hoặc dải ô được xác định có tên tuỳ chỉnh để đơn giản hoá các tham chiếu trong toàn bộ ứng dụng. Tài nguyên
FilterView đại diện cho một dải ô có tên.
- Dải ô được bảo vệ
- Một ô hoặc dải ô được xác định mà bạn không thể sửa đổi. Tài nguyên
ProtectedRange biểu thị một dải ô được bảo vệ.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[],[],null,["# Google Sheets API Overview\n\nThe Google Sheets API is a RESTful interface that lets you read and modify a\nspreadsheet's data. The Sheets API lets you:\n\n- Create spreadsheets\n- Read and write spreadsheet cell values\n- Update spreadsheet formatting\n- Manage Connected Sheets\n\nThe following is a list of common terms used in the Sheets API:\n\n*Spreadsheet*\n\n: The primary object in Google Sheets. It can contain multiple `Sheets`, each\n with structured information contained in `Cells`. The\n [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets)\n resource represents a spreadsheet. It contains a unique `spreadsheetId`\n value.\n\n *Spreadsheet ID*\n : The unique identifier for a spreadsheet. It's a particular string\n containing letters, numbers, and some special characters that reference a\n spreadsheet and it can be derived from the spreadsheet's URL. Spreadsheet\n IDs are stable, even if the spreadsheet name changes. \n\n https://docs.google.com/spreadsheets/d/\u003cvar translate=\"no\"\u003eSPREADSHEET_ID\u003c/var\u003e/edit?gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e#gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e\n\n*Sheet*\n\n: A page or tab within a spreadsheet. The\n [`Sheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets) resource\n represents a sheet. It contains a unique numeric `sheetId` value and sheet\n `title` as part of the\n [`SheetProperties`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#sheetproperties)\n object.\n\n *Sheet ID*\n : The unique identifier for a specific sheet within a spreadsheet. It's a\n particular integer containing numbers that reference a sheet and it can be\n derived from the spreadsheet's URL. Sheet IDs are stable, even if the sheet\n name changes. For an example, see [Spreadsheet ID](#spreadsheet-id).\n\n*Cell*\n\n: An individual field of text or data within a sheet. Cells are arranged in rows\n and columns, and can be grouped as a range of cells. The\n [`Cells`](/workspace/sheets/api/reference/rest/v4/spreadsheets/cells)\n resource represents each cell, but it doesn't have a unique ID value.\n Instead, row and column coordinates identify the cells.\n\n *A1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n column letters and row numbers. This method is the most common and useful\n when referencing an absolute range of cells.\n - `Sheet1!A1:B2` refers to all the cells in the first two rows and columns of Sheet1.\n - `Sheet1!A:A` refers to all the cells in the first column of Sheet1.\n - `Sheet1!1:2` refers to all the cells in the first two rows of Sheet1.\n - `Sheet1!A5:A` refers to all the cells of the first column of Sheet 1, from row 5 onward.\n - `A1:B2` refers to all the cells in the first two rows and columns of the first visible sheet.\n - `Sheet1` refers to all the cells in Sheet1.\n - `'Jon's_Data'!A1:D5` refers to all the cells in the first five rows and four columns of a sheet named \"Jon's_Data.\"\n - `'My Custom Sheet'!A:A` refers to all the cells in the first column of a sheet named \"My Custom Sheet.\"\n - `'My Custom Sheet'` refers to all the cells in \"My Custom Sheet\".\n\n Single quotes are required for sheet names with spaces or special characters.\n\n **Tip** : Where possible, use distinct names for objects in your spreadsheets. For example, A1 (without quotes) refers to cell A1 in the first visible sheet. `'A1'` refers to a sheet with the name A1. Similarly, Sheet1 refers to a sheet with the name Sheet1. However, if there's a named range titled \"Sheet1\", then Sheet1 refers to the named range and `'Sheet1'` refers to the sheet.\n\n *R1C1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n row numbers and column numbers. This method is less common than A1 notation,\n but can be useful when referencing a range of cells relative to a given\n cell's position.\n - `Sheet1!R1C1:R2C2` refers to the first two cells in the top two rows of Sheet1.\n - `R1C1:R2C2` refers to the first two cells in the top two rows of the first visible sheet.\n - `Sheet1!R[3]C[1]` refers to the cell that is three rows below and one column to the right of the current cell.\n\n *Named range*\n : A defined cell or range of cells with a custom name to simplify references\n throughout an application. A\n [`FilterView`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#filterview)\n resource represents a named range.\n\n *Protected range*\n : A defined cell or range of cells that cannot be modified. A\n [`ProtectedRange`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#protectedrange)\n resource represents a protected range.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To learn how to configure and run a Sheets API app, try the\n [JavaScript quickstart](/workspace/sheets/api/quickstart/js)."]]
