Расширенная служба меток дисков

Создавайте ярлыки для файлов и папок на Диске и управляйте ими с помощью расширенного сервиса Google Drive Labels. Благодаря этому расширенному сервису вы можете использовать все функции Drive Labels API в Apps Script.

Чтобы применить или удалить метки Диска, используйте Advanced Drive Service .

Примечание. Это расширенная услуга, которую необходимо включить перед использованием .

Ссылка

Дополнительную информацию об этом сервисе см. в документации API Google Drive Labels . Как и все расширенные службы в Apps Script, служба Drive Labels API использует те же объекты, методы и параметры, что и общедоступный API.

Чтобы сообщить о проблемах и получить другую поддержку, см. руководство по поддержке Google Drive Labels API.

Пример кода

В приведенном ниже примере кода используется версия 2 API.

Список ярлыков

В следующем примере кода показано, как получить список меток, доступных пользователю, делающему запрос.

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);
}

Получить ярлык

В следующем примере кода показано, как получить одну метку по ее имени ресурса (которое является строковым значением метки). Чтобы найти имя метки, получите список меток через API или воспользуйтесь диспетчером меток Диска. Дополнительную информацию о диспетчере меток см. в разделе «Управление метками Диска» .

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);
  }
}

Получение списка ярлыков для объекта на Диске

В следующем примере кода показано, как получить элемент Диска и перечислить все ярлыки, примененные к этому элементу.

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);
  }
}