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

توضّح هذه الصفحة كيفية إزالة تصنيف من ملف واحد في 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 الملف الذي تم تعديل التصنيفات له