إزالة تصنيف من ملف

توضّح هذه الصفحة كيفية إزالة تصنيف من ملف واحد في Google Drive.

لإزالة البيانات الوصفية لتصنيف الملف من ملف، استخدِم العنصر files.modifyLabels. تشير رسالة الأشكال البيانية نص الطلب يحتوي على مثيل ModifyLabelsRequest لتعديل مجموعة التصنيفات في ملف. قد يحتوي الطلب على العديد من والتعديلات التي يتم تطبيقها على كامل. أي، إذا لم يتم إجراء أي تعديلات صالحًا، فلن ينجح التحديث بأكمله ولا شيء مما (من المحتمل اعتمادية) واحدة.

يحتوي ModifyLabelsRequest على مثيل LabelModification وهو تعديل في تسمية على ملف. قد تحتوي أيضًا على مثيل من FieldModification وهو تعديل في حقل التصنيف. لإزالة التصنيف من الملف، ضبط FieldModification.removeLabel على True

في حال نجاح هذا الإجراء، سيتم إدخال النص الأساسي يحتوي على التصنيفات التي تمت إضافتها أو تحديثها بواسطة الطلب. وتقع هذه المجموعات ضمن كائن modifiedLabels من النوع Label.

مثال

يعرض نموذج الرمز البرمجي التالي كيفية استخدام labelId لإزالة جميع الحقول. المرتبطة بالتصنيف باستخدام السمة fileId. على سبيل المثال، إذا كان التصنيف يحتوي على حقلي النص والمستخدم، تؤدي إزالة التصنيف إلى حذف كل من النص والمستخدم الحقول المرتبطة بالتصنيف. في حين أن إلغاء تعيين حقل النص يؤدي إلى إزالته من التصنيف ولكنه يترك حقل المستخدم دون تغيير. لمزيد من المعلومات، يُرجى مراجعة إلغاء ضبط حقل تصنيف في ملف

ModifyLabelsRequest modifyLabelsRequest =
  new ModifyLabelsRequest()
      .setLabelModifications(
          ImmutableList.of(
              new LabelModification()
                .setLabelId("LABEL_ID")
                .setRemoveLabel(true)));

ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabelsRequest).execute();

label_modification = {'labelId':'LABEL_ID', 'removeLabel': True]}

modified_labels = drive_service.files().modifyLabels(fileId="FILE_ID", body = {'labelModifications' : [label_modification]}).execute();

/**
* 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 من الملف الذي تم إنشاء التصنيفات له تم تعديله.