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

این صفحه نحوه حذف برچسب از روی یک فایل گوگل درایو را توضیح می‌دهد.

برای حذف ابرداده‌های برچسب فایل از یک فایل، از متد 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 فایلی که برچسب‌ها برای آن تغییر داده شده‌اند.