Method: labels.disable

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

Una vez inhabilitada, una etiqueta se puede borrar 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

Obligatorio. Etiqueta el nombre del recurso.

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)

Los campos que se deben actualizar. Se debe especificar al menos un campo. El disabledPolicy raíz se da por sentado y no se debe especificar. Se puede usar un solo * como abreviatura para actualizar todos los campos.
useAdminAccess

boolean

Establece este valor en true para usar las credenciales de administrador del usuario. El servidor verificará que el usuario sea administrador de la etiqueta antes de permitir el acceso.
writeControl

object (WriteControl)

Proporciona control sobre cómo se ejecutan las solicitudes de escritura. El valor predeterminado es no establecerlo, 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. Si no se especifica, se usarán los valores del idioma predeterminado configurado.

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.