Создать & опубликовать лейбл

На этой странице описано, как создать и опубликовать ярлык.

Создать ярлык

Чтобы создать метку, используйте метод create в коллекции labels . Метки могут содержать одно или несколько Fields .

Также необходимо указать:

• LabelType .

• title метки с помощью метода property .

• useAdminAccess имеет true , чтобы использовать учетные данные администратора пользователя. Сервер проверяет, что пользователь является администратором с привилегией «Управление метками», прежде чем разрешить доступ.

В этом примере создается стандартная метка администратора с указанным заголовком и одним Field SelectionOptions с двумя Choices .

Питон

label_body = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
        'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
        'list_options': {},
        'choices': [{
            'properties': {
                'display_name': 'CHOICE_1'
            }
        }, {
            'properties': {
                'display_name': 'CHOICE_2'
            }
        }]
    }
}]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

Node.js

var label = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
    'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
    'list_options': {},
    'choices': [{
        'properties': {
        'display_name': 'CHOICE_1'
        }
    }, {
        'properties': {
        'display_name': 'CHOICE_2'
        }
    }]
    }
}]
};

service.labels.create({
  'resource': label,
  'use_admin_access': true
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

Ярлык создается в State UNPUBLISHED_DRAFT . Он должен быть PUBLISHED для использования в файлах и быть видимым для пользователей. Дополнительные сведения см. в разделе Жизненный цикл метки .

Пределы меток

При создании и применении меток действуют следующие ограничения:

• Стандартные этикетки — 150
• Поля на этикетку — 10
• Пользовательских ярлыков на файл — 5

Работа с полями в метках

Field Type	Что могут делать пользователи	Рекомендации и ограничения формата
SelectionOptions	Выберите один или несколько вариантов из списка	Максимальное количество поддерживаемых опций — 200. Максимальное количество вариантов выбора для файла — 10, как указано в ListOptions
IntegerOptions	Введите числовое значение	Поддерживаются только целые числа
DateOptions	Выберите календарную дату	(Необязательно) Date format может быть установлен на «Длинный: месяц ДД, ГГГГ» или «Короткий: ММ/ДД/ГГ».
TextOptions	Введите текст в текстовое поле	Максимальное поддерживаемое количество символов — 100.
UserOptions	Выберите одного или нескольких пользователей из контактов Google Workspace.	Максимальное количество пользовательских записей для файла — 10, как указано в ListOptions

Опубликовать ярлык

API Labels позволяет опубликовать черновой вариант этикетки после его завершения.

Чтобы опубликовать метку, используйте метод publish и укажите:

• Ресурс Label , представляющий каждую метку. Он содержит Name ресурса и ID , который является глобальным уникальным идентификатором метки.

• useAdminAccess имеет true , чтобы использовать учетные данные администратора пользователя. Сервер проверяет, что пользователь является администратором с привилегией «Управление метками», прежде чем разрешить доступ.

В этом примере ID используется для идентификации и публикации правильной метки.

Питон

service.labels().publish(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.publish({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

После публикации метки она переходит в State PUBLISHED , а идентификатор редакции метки увеличивается. После этого метка будет видна пользователям и может быть применена к файлам. Дополнительные сведения см. в разделе Жизненный цикл метки .

Ограничения при публикации ярлыков

• После публикации ярлык не может вернуться в исходное состояние черновика. Дополнительные сведения см. в разделе Жизненный цикл метки .

• Публикация метки создает новую опубликованную редакцию. Все предыдущие черновые версии удаляются. Ранее опубликованные версии сохраняются, но при необходимости могут быть автоматически удалены.

• После публикации некоторые изменения больше не допускаются. Как правило, это означает, что любое изменение, которое делает недействительными или вызывает новые ограничения на существующие метаданные, связанные с меткой, отклоняется. Например, следующие изменения метки не допускаются после публикации метки:

  • Ярлык удаляется напрямую. (Сначала его необходимо отключить, а затем удалить.)
  • Field.FieldType изменен.
  • Обновления параметров проверки поля отклоняют что-то ранее принятое.
  • Уменьшение максимального количества записей.