إلغاء ضبط حقل تصنيف على ملف

توضّح هذه الصفحة كيفية إلغاء ضبط تصنيف. Field على أغنية واحدة ملف Google Drive.

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

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

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

مثال

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

LabelFieldModification fieldModification =
  new LabelFieldModification().setFieldId("FIELD_ID").setUnsetValues(true);

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','unsetValues':True}
label_modification = {'labelId':'LABEL_ID', 'fieldModifications':[field_modification]}

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

/**
* Unset a label with a field on a Drive file
* @return{obj} updated label data
**/
async function unsetLabelField() {
  // 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',
    'unsetValues': True,
  };
  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.
• LABEL_ID: السمة labelId للتصنيف المطلوب تعديله.
• FILE_ID: fileId من الملف الذي تم إنشاء التصنيفات له تم تعديله.