Xoá nhãn khỏi 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.
Trang này mô tả cách xoá nhãn trên một tệp trong Google Drive.
Để xoá siêu dữ liệu nhãn tệp khỏi một tệp, hãy dùng phương thức files.modifyLabels
. Nội dung yêu cầu chứa một phiên bản của ModifyLabelsRequest
để sửa đổi bộ nhãn trên một tệp. Yêu cầu có thể chứa một số nội dung sửa đổi được áp dụng một cách riêng lẻ. Tức là nếu có bất kỳ nội dung sửa đổi nào không hợp lệ, thì toàn bộ quá trình cập nhật sẽ không thành công và không có thay đổi nào (có thể phụ thuộc) được áp dụng.
ModifyLabelsRequest
chứa một thực thể của LabelModification
. Đây là một nội dung sửa đổi đối với nhãn trên một tệp. Nội dung này cũng có thể chứa một thực thể của FieldModification
. Đây là một điểm sửa đổi đối với trường của nhãn. Để xoá nhãn khỏi tệp, hãy đặt FieldModification.removeLabel
thành True
.
Nếu thành công, nội dung phản hồi sẽ chứa các nhãn được thêm hoặc cập nhật theo yêu cầu. Các biến này nằm trong một đối tượng modifiedLabels
thuộc loại Label
.
Ví dụ:
Mã mẫu sau đây cho biết cách sử dụng labelId
để xoá tất cả các trường được liên kết với nhãn bằng cách sử dụng fileId
. Ví dụ: nếu một nhãn chứa cả trường văn bản và trường người dùng, thì việc xoá nhãn sẽ xoá cả trường văn bản và trường người dùng được liên kết với nhãn đó. Trong khi đó, việc huỷ đặt trường văn bản sẽ xoá trường văn bản đó khỏi nhãn nhưng không ảnh hưởng đến trường người dùng. Để biết thêm thông tin, hãy xem bài viết Huỷ đặt trường nhãn cho tệp.
Java
ModifyLabelsRequest modifyLabelsRequest =
new ModifyLabelsRequest()
.setLabelModifications(
ImmutableList.of(
new LabelModification()
.setLabelId("LABEL_ID")
.setRemoveLabel(true)));
ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabels
Request).execute();
Python
label_modification = {'labelId':'LABEL_ID', 'removeLabel': True]}
modified_labels = drive_service.files().modifyLabels(fileId="FILE_ID", body = {'labelModifications
' : [label_modification]}).execute();
Node.js
/**
* Remove a label on a Drive file
* @return{obj} updated label data
**/
async function removeLabel() {
// 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});
const labelModification = {
'labelId': 'LABEL_ID',
'removeLabel': True,
};
const labelModificationRequest = {
'labelModifications': [labelModification],
};
try {
const updateResponse = await service.files.modifyLabels({
fileId: 'FILE_ID',
resource: labelModificationRequest,
});
return updateResponse;
}
catch (err) {
// TODO (developer) - Handle error
throw err;
}
Thay thế nội dung sau:
- LABEL_ID:
labelId
của nhãn cần sửa đổi. Để xác định vị trí của nhãn trên một tệp, hãy sử dụng phương thức files.listLabels
.
- FILE_ID:
fileId
của tệp mà nhãn được sửa đổi.
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-09-01 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-09-01 UTC."],[],[],null,["This page describes how to remove a label on a single Google Drive file.\n\nTo remove the file label metadata from a file, use the\n[`files.modifyLabels`](/workspace/drive/api/v2/reference/files/modifyLabels) method. The\n[request body](/workspace/drive/api/reference/rest/v2/files/modifyLabels#request-body)\ncontains an instance of\n[`ModifyLabelsRequest`](/workspace/drive/api/reference/rest/v2/files/modifyLabels#modifylabelsrequest)\nto modify the set of labels on a file. The request might contain several\nmodifications that are applied atomically. That is, if any modifications aren't\nvalid, then the entire update is unsuccessful and none of the (potentially\ndependent) changes are applied.\n\nThe `ModifyLabelsRequest` contains an instance of\n[`LabelModification`](/workspace/drive/api/reference/rest/v2/files/modifyLabels#labelmodification)\nwhich is a modification to a label on a file. It might also contain an instance\nof\n[`FieldModification`](/workspace/drive/api/reference/rest/v2/files/modifyLabels#fieldmodification)\nwhich is a modification to a label's field. To remove the label from the file,\nset `FieldModification.removeLabel` to `True`.\n\nIf successful, the [response\nbody](/workspace/drive/api/reference/rest/v2/files/modifyLabels#response-body) contains\nthe labels added or updated by the request. These exist within a\n`modifiedLabels` object of type [`Label`](/workspace/drive/api/reference/rest/v2/Label).\n\nExample\n\nThe following code sample shows how to use the `labelId` to remove all fields\nassociated with the label using the `fileId`. For example, if a label contains\nboth text and user fields, removing a label deletes *both* the text and user\nfields associated with the label. Whereas, unsetting the text field removes it\nfrom the label but leaves the user field untouched. For more information, see\n[Unset a label field on a file](/workspace/drive/api/guides/unset-label). \n\nJava \n\n ModifyLabelsRequest modifyLabelsRequest =\n new ModifyLabelsRequest()\n .setLabelModifications(\n ImmutableList.of(\n new LabelModification()\n .setLabelId(&\u003cvar translate=\"no\"\u003equot;LAB\u003c/var\u003eEL_ID\")\n .setRemoveLabel(true)));\n\n ModifyLabelsResponse modifyLabelsResponse = driveService.files().modi\u003cvar translate=\"no\"\u003efyLabel\u003c/var\u003es(\"FILE_ID\", modifyLabelsRequest).execute();\n\nPython \n\n label_modification = {'labelI\u003cvar translate=\"no\"\u003ed'\u003c/var\u003e:'LABEL_ID', 'removeLabel': True]}\n\n modified_labels = drive_service.files\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-p\"\u003e()\u003c/span\u003e\u003cspan class=\"devsite-syntax-o\"\u003e.\u003c/span\u003e\u003cspan class=\"devsite-syntax-n\"\u003emodi\u003c/span\u003e\u003c/var\u003efyLabels(fileId=\"FILE_ID\", body = {'labelModifications' : [label_modification]}).execute();\n\nNode.js \n\n /**\n * Remove a label on a Drive file\n * @return{obj} updated label data\n **/\n async function removeLabel() {\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 const labelM\u003cvar translate=\"no\"\u003eodificat\u003c/var\u003eion = {\n 'labelId': 'LABEL_ID',\n 'removeLabel': True,\n };\n const labelModificationRequest = {\n 'labelModifications': [labelModification],\n };\n try {\n const upd\u003cvar translate=\"no\"\u003eateResp\u003c/var\u003eonse = await service.files.modifyLabels({\n fileId: 'FILE_ID',\n resource: labelModificationRequest,\n });\n return updateResponse;\n } catch (err) {\n // TODO (developer) - Handle error\n throw err;\n }\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eLABEL_ID\u003c/var\u003e: The `labelId` of the label to modify. To locate the labels on a file, use the [`files.listLabels`](/workspace/drive/api/v2/reference/files/listLabels) method.\n- \u003cvar translate=\"no\"\u003eFILE_ID\u003c/var\u003e: The `fileId` of the file for which the labels are modified."]]