برچسب‌ها را روی یک فایل فهرست کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
سازمان شما می‌تواند چندین برچسب داشته باشد، با برچسب‌هایی که هر تعداد فیلد دارند. این صفحه نحوه فهرست کردن همه برچسب‌ها را در یک فایل Google Drive توضیح می‌دهد.
برای فهرست کردن برچسب‌های فایل، از روش files.listLabels استفاده کنید. بدنه درخواست باید خالی باشد. این روش همچنین از پارامتر query اختیاری maxResults استفاده می‌کند تا حداکثر تعداد برچسب‌ها را برای بازگشت در هر صفحه تنظیم کند. اگر تنظیم نشود، 100 نتیجه برگردانده می شود.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی لیستی از برچسب های اعمال شده بر روی یک فایل است. اینها در یک items مورد از نوع Label وجود دارند.
مثال
نمونه کد زیر نحوه استفاده از fileId برچسب را برای بازیابی برچسب های صحیح نشان می دهد.
جاوا
List<Label> labelList =
labelsDriveClient.files().listLabels("FILE_ID").execute().getItems();
پایتون
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;
}
}
FILE_ID با fileId فایلی که لیست برچسب‌ها را برای آن می‌خواهید جایگزین کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
