ضبط حقل تصنيف على ملف

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

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

يحتوي ModifyLabelsRequest على مثيل LabelModification وهو تعديل في تسمية على ملف. قد تحتوي أيضًا على مثيل من FieldModification وهو تعديل في حقل التصنيف.

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

مثال

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

LabelFieldModification fieldModification =
new LabelFieldModification().setFieldId("FIELD_ID").setSetTextValues(ImmutableList.of("VALUE"));

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

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

/**
* Set a label with a text field on a Drive file
* @return{obj} updated label data
**/
async function setLabelTextField() {
  // 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',
    'setTextValues': ['VALUE'],
  };
  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.
• VALUE: حقل value الجديد لهذا الحقل
• LABEL_ID: السمة labelId للتصنيف المطلوب تعديله.
• FILE_ID: fileId من الملف الذي تم إنشاء التصنيفات له تم تعديله.

ملاحظات

• لضبط تصنيف لا يحتوي على حقول، يجب تطبيق labelModifications بدون أي حقول. هناك fieldModifications.
• لضبط قيم لخيارات حقول التحديد، استخدم رقم تعريف القيمة Choice الذي يمكنك الحصول عليه من خلال جلب مخطط التصنيفات في واجهة برمجة تطبيقات التصنيفات في Drive.
• إذا كانت السمة Field تتيح قوائم القيم، يمكن فقط أن تتضمّن مجموعة قيم متعددة. وبخلاف ذلك، ستتلقى استجابة خطأ 400: Bad Request.
• اضبط نوع القيمة المناسب للسمة Field المحدّدة (مثل عدد صحيح أو نص وغير ذلك)، وبخلاف ذلك ستتلقى ردًّا بالخطأ 400: Bad Request. يمكنك استرداد نوع بيانات الحقل باستخدام دالة واجهة برمجة تطبيقات التصنيفات في Drive.