یک برچسب را از یک فایل حذف کنید

در این صفحه نحوه حذف برچسب روی یک فایل 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();

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 فایلی که برچسب‌ها برای آن اصلاح شده‌اند.