Liệt kê các nhãn trên tệp
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.
Tổ chức của bạn có thể có nhiều nhãn, trong đó mỗi nhãn có thể có bao nhiêu trường tuỳ ý. Trang này mô tả cách liệt kê tất cả nhãn trên một tệp duy nhất trên Google Drive.
Để liệt kê các nhãn tệp, hãy sử dụng phương thức files.listLabels
. Nội dung yêu cầu phải trống. Phương thức này cũng lấy tham số truy vấn không bắt buộc maxResults
để đặt số lượng nhãn tối đa cần trả về trên mỗi trang. Nếu bạn không đặt giá trị này, hệ thống sẽ trả về 100 kết quả.
Nếu thành công, nội dung phản hồi sẽ chứa danh sách nhãn được áp dụng cho một tệp. Các biến này nằm trong một đối tượng items
thuộc loại Label
.
Ví dụ:
Mã mẫu sau đây cho biết cách sử dụng fileId
của nhãn để truy xuất các nhãn chính xác.
Java
List<Label> labelList =
labelsDriveClient.files().listLabels("FILE_ID").execute().getItems();
Python
label_list_response = drive_service.files().listLabels(fileId="FILE_ID").execute();
Node.js
/**
* Lists all the labels on a Drive file
* @return{obj} a list of Labels
**/
async function listLabels() {
// Get credentials and build service
// TODO (developer) - Use appropriate auth mechanism for your app
const {GoogleAuth} = require('google-auth-library');
const {google} = require('googleapis');
const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
const service = google.drive({version: 'v3', auth});
try {
const labelListResponse = await service.files.listLabels({
fileId: 'FILE_ID',
});
return labelListResponse;
} catch (err) {
// TODO (developer) - Handle error
throw err;
}
}
Thay thế FILE_ID bằng fileId
của tệp mà bạn muốn có danh sách nhãn.
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-04 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-04 UTC."],[],[],null,["# List labels on a file\n\nYour organization can have multiple labels, with labels having any number of\nfields. This page describes how to list all labels on a single Google Drive\nfile.\n\nTo list the file labels, use the\n[`files.listLabels`](/workspace/drive/api/v2/reference/files/listLabels) method. The\nrequest body must be empty. The method also takes the optional query parameter\n`maxResults` to set the maximum number of labels to return per page. If not set,\n100 results are returned.\n\nIf successful, the [response\nbody](/workspace/drive/api/reference/rest/v2/files/listLabels#response-body) contains the\nlist of labels applied to a file. These exist within an `items` object of type\n[`Label`](/workspace/drive/api/reference/rest/v2/Label).\n\nExample\n-------\n\nThe following code sample shows how to use the label's `fileId` to retrieve the\ncorrect labels. \n\n### Java\n\n List\u003cLabel\u003e labelList =\n labelsDriveClient.files().listLabels(\"\u003cvar translate=\"no\"\u003eFILE_ID\u003c/var\u003e\").execute().getItems();\n\n### Python\n\n label_list_response = drive_service.files().listLabels(fileId=\"\u003cvar translate=\"no\"\u003eFILE_ID\u003c/var\u003e\").execute();\n\n### Node.js\n\n /**\n * Lists all the labels on a Drive file\n * @return{obj} a list of Labels\n **/\n async function listLabels() {\n // Get credentials and build service\n // TODO (developer) - Use appropriate auth mechanism for your app\n\n const {GoogleAuth} = require('google-auth-library');\n const {google} = require('googleapis');\n\n const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});\n const service = google.drive({version: 'v3', auth});\n try {\n const labelListResponse = await service.files.listLabels({\n fileId: '\u003cvar translate=\"no\"\u003eFILE_ID\u003c/var\u003e',\n });\n return labelListResponse;\n } catch (err) {\n // TODO (developer) - Handle error\n throw err;\n }\n }\n\nReplace \u003cvar translate=\"no\"\u003eFILE_ID\u003c/var\u003e with the `fileId` of the file for which you\nwant the list of labels."]]