Отключить, включить и удалить метку

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

• Отключить метку
• Включить метку
• Удалить метку

Отключить метку

Отключение метки приводит к созданию новой отключенной опубликованной версии на основе текущей опубликованной версии. Если существует черновая версия, создается новая отключенная черновая версия на основе последней черновой версии. Более старые черновые версии удаляются. Для получения дополнительной информации см. раздел «Жизненный цикл меток» .

После отключения пользователи все еще могут применить эту метку через API меток Google Drive. Метка по-прежнему будет отображаться там, где она уже была применена, и в результатах поиска. Отключенную метку можно удалить .

Чтобы отключить опубликованную метку, используйте метод disable ресурса labels .

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

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

• Параметр запроса useAdminAccess устанавливается в true , чтобы использовать учетные данные администратора пользователя. Прежде чем разрешить доступ, сервер проверяет, обладает ли пользователь необходимыми правами администратора по управлению метками классификации .

В следующем примере кода показано, как использовать id метки для отключения нужной метки:

Python

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

Node.js

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

Замените ID на идентификатор метки, которую нужно отключить.

Метка имеет State DISABLED , и идентификатор ревизии метки увеличивается на единицу. Пользователи могут применить метку через API меток дисков. Однако отключенная метка не отображается в пользовательском интерфейсе, если не настроено поле showInApply объекта DisabledPolicy .

Включить метку

Включение отключенной метки восстанавливает ее опубликованное состояние. Это приводит к созданию новой опубликованной версии на основе текущей отключенной опубликованной версии. Если существует уже отключенная черновая версия, на ее основе создается новая версия, которая затем включается. Для получения дополнительной информации см. раздел «Жизненный цикл метки» .

Чтобы включить отключенную метку, используйте метод enable ресурса labels .

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

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

• Параметр запроса useAdminAccess устанавливается в true , чтобы использовать учетные данные администратора пользователя. Прежде чем разрешить доступ, сервер проверяет, обладает ли пользователь необходимыми правами администратора по управлению метками классификации .

В следующем примере кода показано, как использовать id метки для включения нужной метки:

Python

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

Node.js

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

Замените ID на идентификатор метки, которую необходимо включить.

Метка имеет State PUBLISHED , а идентификатор ревизии метки увеличивается на единицу. Пользователи могут просматривать и применять метки к файлам через API меток Google Диска.

Удалить метку

Удалить можно только черновики и отключенные метки. При удалении метки все случаи, когда она применялась ранее, включая соответствующие значения полей, введенные пользователями, безвозвратно удаляются из соответствующих файлов Google Drive.

Для удаления метки необходимо сначала отключить её, а затем использовать метод delete для ресурса labels .

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

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

• Параметр запроса useAdminAccess устанавливается в true , чтобы использовать учетные данные администратора пользователя. Прежде чем разрешить доступ, сервер проверяет, обладает ли пользователь необходимыми правами администратора по управлению метками классификации .

В следующем примере кода показано, как использовать id метки для удаления нужной метки:

Python

response = service.labels().delete(
    name='labels/ID',
    useAdminAccess=True
).execute()

Node.js

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

Замените ID на идентификатор метки, которую нужно удалить.

Метка имеет State DELETED , и ее идентификатор ревизии увеличивается. Метку нельзя применить, и удаленные метки в конечном итоге удаляются. Для получения дополнительной информации см. раздел «Жизненный цикл метки» .