Method: labels.disable

Отключить опубликованную метку. Подробнее см. в разделе Отключение, включение и удаление метки .

Отключение метки приведёт к созданию новой отключённой опубликованной версии на основе текущей опубликованной версии. При наличии черновой версии будет создана новая отключённая черновая версия на основе последней черновой версии. Более старые черновые версии будут удалены.

После отключения метку можно удалить с помощью labels.delete .

HTTP-запрос

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
name

string

Обязательно. Имя ресурса метки.

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
Поля
updateMask

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать хотя бы одно поле. Корневая disabledPolicy подразумевается и не должна быть указана. Для сокращения обновления каждого поля можно использовать один символ * .

useAdminAccess

boolean

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

writeControl

object ( WriteControl )

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

disabledPolicy

object ( DisabledPolicy )

Отключена политика использования.

languageCode

string

Код языка BCP-47, используемый для оценки локализованных меток полей. Если код не указан, будут использоваться значения на языке, настроенном по умолчанию.

Тело ответа

В случае успеха тело ответа содержит экземпляр Label .

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

Более подробную информацию смотрите в Руководстве по авторизации .