Список меток в файле
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В вашей организации может быть несколько меток с любым количеством полей. На этой странице описано, как составить список всех меток в одном файле Google Диска.
Чтобы вывести список меток файлов, используйте метод files.listLabels
. Тело запроса должно быть пустым. Метод также принимает необязательный параметр запроса 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 "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-04 UTC.
[null,null,["Последнее обновление: 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."]]