خدمة التصنيفات المتقدّمة في Drive

يمكنك إنشاء تصنيفات لملفات ومجلدات Drive وإدارتها باستخدام خدمة Google Drive Labels المتقدّمة. باستخدام هذه الخدمة المتقدّمة، يمكنك الاستفادة من جميع ميزات واجهة برمجة التطبيقات الخاصة بتصنيفات Drive في Apps Script.

لتطبيق تصنيفات Drive أو إزالتها، استخدِم خدمة Drive المتقدّمة.

ملاحظة: هذه خدمة متقدّمة يجب تفعيلها قبل استخدامها.

مراجع

لمزيد من المعلومات حول هذه الخدمة، يُرجى الاطّلاع على مستندات Google Drive Labels API. كما هو الحال مع جميع الخدمات المتقدّمة في "برمجة التطبيقات"، تستخدم خدمة Drive Labels API الكائنات والطرق والمعلَمات نفسها التي تستخدمها واجهة برمجة التطبيقات العامة.

للإبلاغ عن مشاكل والعثور على معلومات دعم أخرى، يُرجى الاطّلاع على دليل الدعم الخاص بـ Google Drive Labels API.

نموذج التعليمات البرمجية

يستخدم نموذج الرمز البرمجي أدناه الإصدار 2 من واجهة برمجة التطبيقات.

قائمة التصنيفات

يوضّح نموذج الرمز البرمجي التالي كيفية الحصول على قائمة بالتصنيفات المتاحة للمستخدم الذي يرسل الطلب.

advanced/driveLabels.gs

عرض على GitHub

/**
 * List labels available to the user.
 */
function listLabels() {
  let pageToken = null;
  let labels = [];
  do {
    try {
      const response = DriveLabels.Labels.list({
        publishedOnly: true,
        pageToken: pageToken
      });
      pageToken = response.nextPageToken;
      labels = labels.concat(response.labels);
    } catch (err) {
      // TODO (developer) - Handle exception
      console.log('Failed to list labels with error %s', err.message);
    }
  } while (pageToken != null);

  console.log('Found %d labels', labels.length);
}

الحصول على تصنيف

يوضّح نموذج الرمز البرمجي التالي كيفية الحصول على تصنيف واحد من خلال اسم المورد (وهو قيمة السلسلة الخاصة بالتصنيف). للعثور على اسم التصنيف، احصل على قائمة بالتصنيفات من خلال واجهة برمجة التطبيقات أو استخدِم أداة إدارة التصنيفات في Drive. لمزيد من المعلومات حول أداة إدارة التصنيفات، انتقِل إلى إدارة تصنيفات Drive.

advanced/driveLabels.gs

عرض على GitHub

/**
 * Get a label by name.
 * @param {string} labelName The label name.
 */
function getLabel(labelName) {
  try {
    const label = DriveLabels.Labels.get(labelName, {view: 'LABEL_VIEW_FULL'});
    const title = label.properties.title;
    const fieldsLength = label.fields.length;
    console.log(`Fetched label with title: '${title}' and ${fieldsLength} fields.`);
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log('Failed to get label with error %s', err.message);
  }
}

عرض تصنيفات عنصر في Drive

يوضّح نموذج الرمز التالي كيفية الحصول على عنصر في Drive وإدراج جميع التصنيفات المطبّقة على هذا العنصر.

advanced/driveLabels.gs

عرض على GitHub

/**
 * List Labels on a Drive Item
 * Fetches a Drive Item and prints all applied values along with their to their
 * human-readable names.
 *
 * @param {string} fileId The Drive File ID
 */
function listLabelsOnDriveItem(fileId) {
  try {
    const appliedLabels = Drive.Files.listLabels(fileId);

    console.log('%d label(s) are applied to this file', appliedLabels.labels.length);

    appliedLabels.labels.forEach((appliedLabel) => {
      // Resource name of the label at the applied revision.
      const labelName = 'labels/' + appliedLabel.id + '@' + appliedLabel.revisionId;

      console.log('Fetching Label: %s', labelName);
      const label = DriveLabels.Labels.get(labelName, {view: 'LABEL_VIEW_FULL'});

      console.log('Label Title: %s', label.properties.title);

      Object.keys(appliedLabel.fields).forEach((fieldId) => {
        const fieldValue = appliedLabel.fields[fieldId];
        const field = label.fields.find((f) => f.id == fieldId);

        console.log(`Field ID: ${field.id}, Display Name: ${field.properties.displayName}`);
        switch (fieldValue.valueType) {
          case 'text':
            console.log('Text: %s', fieldValue.text[0]);
            break;
          case 'integer':
            console.log('Integer: %d', fieldValue.integer[0]);
            break;
          case 'dateString':
            console.log('Date: %s', fieldValue.dateString[0]);
            break;
          case 'user':
            const user = fieldValue.user.map((user) => {
              return `${user.emailAddress}: ${user.displayName}`;
            }).join(', ');
            console.log(`User: ${user}`);
            break;
          case 'selection':
            const choices = fieldValue.selection.map((choiceId) => {
              return field.selectionOptions.choices.find((choice) => choice.id === choiceId);
            });
            const selection = choices.map((choice) => {
              return `${choice.id}: ${choice.properties.displayName}`;
            }).join(', ');
            console.log(`Selection: ${selection}`);
            break;
          default:
            console.log('Unknown: %s', fieldValue.valueType);
            console.log(fieldValue.value);
        }
      });
    });
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log('Failed with error %s', err.message);
  }
}