Method: labels.disable

Inhabilita una etiqueta publicada. Para obtener más información, consulta Cómo inhabilitar, habilitar y borrar una etiqueta.

Si inhabilitas una etiqueta, se generará una nueva revisión publicada inhabilitada basada en la revisión publicada actual. Si hay una revisión de borrador, se creará una nueva revisión de borrador inhabilitada basada en la revisión de borrador más reciente. Se borrarán las revisiones de borrador más antiguas.

Una vez inhabilitada, se puede borrar una etiqueta con labels.delete.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Es obligatorio. Es el nombre del recurso de la etiqueta.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
Campos
updateMask

string (FieldMask format)

Son los campos que se deben actualizar. Se debe especificar al menos un campo. El disabledPolicy raíz está implícito y no se debe especificar. Se puede usar un solo * como abreviatura para actualizar todos los campos.
useAdminAccess

boolean

Se debe establecer en true para usar las credenciales de administrador del usuario. El servidor verificará que el usuario sea administrador del sello antes de permitir el acceso.
writeControl

object (WriteControl)

Proporciona control sobre cómo se ejecutan las solicitudes de escritura. El valor predeterminado es no establecido, lo que significa que prevalece la última escritura.
disabledPolicy

object (DisabledPolicy)

Política inhabilitada para usar.
languageCode

string

Es el código de idioma BCP-47 que se usará para evaluar las etiquetas de campo localizadas. Cuando no se especifica, se usan los valores del idioma configurado predeterminado.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Label.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta la Guía de autorización.