На этой странице описано, как установить метку « Field
для одного файла на Google Диске.
Чтобы добавить метаданные в файл путем установки метки файла, используйте метод files.modifyLabels
. Тело запроса содержит экземпляр ModifyLabelsRequest
для изменения набора меток в файле. Запрос может содержать несколько модификаций, которые применяются атомарно. То есть, если какие-либо изменения недействительны, то все обновление окажется неудачным и ни одно из (потенциально зависимых) изменений не будет применено.
ModifyLabelsRequest
содержит экземпляр LabelModification
, который является модификацией метки в файле. Он также может содержать экземпляр FieldModification
, который является модификацией поля метки.
В случае успеха тело ответа содержит метки, добавленные или обновленные запросом. Они существуют внутри modifiedLabels
объектаLabels типа Label
.
Пример
В следующем примере кода показано, как использовать fieldId
текстового поля, чтобы установить значение для этого Field
в файле. Когда Field
метки изначально установлено для файла, оно применяет метку к файлу. Затем вы можете отменить настройку одного поля или удалить все поля, связанные с меткой. Дополнительные сведения см. в разделах «Отмена установки поля метки в файле» и «Удаление метки из файла» .
Джава
LabelFieldModification fieldModification =
new LabelFieldModification().setFieldId("FIELD_ID").setSetTextValues(ImmutableList.of("VALUE"));
ModifyLabelsRequest modifyLabelsRequest =
new ModifyLabelsRequest()
.setLabelModifications(
ImmutableList.of(
new LabelModification()
.setLabelId("LABEL_ID")
.setFieldModifications(ImmutableList.of(fieldModification))));
ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabelsRequest).execute();
Питон
field_modification = {'fieldId':'FIELD_ID','setTextValues':['VALUE']}
label_modification = {'labelId':'LABEL_ID', 'fieldModifications':[field_modification]}
modified_labels = drive_service.files().modifyLabels(fileId="FILE_ID", body = {'labelModifications' : [label_modification]}).execute()
Node.js
/**
* Set a label with a text field on a Drive file
* @return{obj} updated label data
**/
async function setLabelTextField() {
// 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 fieldModification = {
'fieldId': 'FIELD_ID',
'setTextValues': ['VALUE'],
};
const labelModification = {
'labelId': 'LABEL_ID',
'fieldModifications': [fieldModification],
};
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;
}
}
Замените следующее:
- FIELD_ID :
fieldId
поля, которое нужно изменить. Чтобы найтиfieldId
, получите метку с помощью Google Drive Labels API . - VALUE : новое
value
для этого поля. - LABEL_ID :
labelId
метки, которую нужно изменить. - FILE_ID :
fileId
файла, для которого изменены метки.
Примечания
- Чтобы установить метку без полей, примените
labelModifications
без присутствияfieldModifications
. - Чтобы задать значения для параметров поля выбора, используйте идентификатор
Choice
значения, которое можно получить, получив схему метки в Drive Labels API . - Только
Field
, которое поддерживает списки значений, может иметь несколько значений, в противном случае вы получите ответ об ошибке400: Bad Request
. - Установите правильный тип значения для выбранного
Field
(например, целое число, текст, пользователь и т. д.), иначе вы получите ответ об ошибке400: Bad Request
. Вы можете получить тип данных поля с помощью Drive Labels API .