توضّح هذه الصفحة كيفية إزالة تصنيف من ملف واحد في Google Drive.
لإزالة البيانات الوصفية لتصنيف الملف من ملف، استخدِم العنصر
files.modifyLabels
. تشير رسالة الأشكال البيانية
نص الطلب
يحتوي على مثيل
ModifyLabelsRequest
لتعديل مجموعة التصنيفات في ملف. قد يحتوي الطلب على العديد من
والتعديلات التي يتم تطبيقها على كامل. أي، إذا لم تكن أي تعديلات
صالحًا، فلن ينجح التحديث بأكمله ولا شيء مما (من المحتمل
اعتمادية) واحدة.
يحتوي ModifyLabelsRequest
على مثيل
LabelModification
وهو تعديل في تسمية على ملف. قد تحتوي أيضًا على مثيل
من
FieldModification
وهو تعديل في حقل التصنيف. لإزالة التصنيف من الملف،
ضبط FieldModification.removeLabel
على True
في حال نجاح هذا الإجراء، سيتم إدخال
النص الأساسي يحتوي على
التصنيفات التي تمت إضافتها أو تحديثها بواسطة الطلب. وتقع هذه المجموعات ضمن
كائن modifiedLabels
من النوع Label
.
مثال
يعرض نموذج الرمز البرمجي التالي كيفية استخدام labelId
لإزالة جميع الحقول.
المرتبطة بالتصنيف باستخدام السمة fileId
. على سبيل المثال، إذا كان التصنيف يحتوي على
حقلي النص والمستخدم، تؤدي إزالة التصنيف إلى حذف كل من النص والمستخدم
الحقول المرتبطة بالتصنيف. في حين أن إلغاء تعيين حقل النص يؤدي إلى إزالته
من التصنيف ولكنه يترك حقل المستخدم دون تغيير. لمزيد من المعلومات، يُرجى مراجعة
إلغاء ضبط حقل تصنيف في ملف
Java
ModifyLabelsRequest modifyLabelsRequest =
new ModifyLabelsRequest()
.setLabelModifications(
ImmutableList.of(
new LabelModification()
.setLabelId("LABEL_ID")
.setRemoveLabel(true)));
ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabelsRequest).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;
}
استبدِل ما يلي:
- LABEL_ID: السمة
labelId
للتصنيف المطلوب تعديله. لتحديد الموقع التسميات الموجودة على ملف، استخدمfiles.listLabels
. - FILE_ID:
fileId
من الملف الذي تم إنشاء التصنيفات له تم تعديله.