Method: labels.disable

Inhabilitar una etiqueta publicada Si inhabilitas una etiqueta, se inhabilitará una nueva revisión publicada en función de la revisión publicada actualmente. Si hay una revisión en borrador, se creará un nuevo borrador inhabilitado en función de la revisión más reciente. Se borrarán las revisiones de borrador anteriores.

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

Obligatorio. Nombre del recurso de 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)

Los campos que se deben actualizar. Se debe especificar al menos un campo. La raíz disabledPolicy está implícita y no se debe especificar. Se puede usar un solo elemento * como abreviatura para actualizar cada campo.

useAdminAccess

boolean

Configúralo 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. La configuración predeterminada es no establecida, lo que significa que prevalece la última escritura.

disabledPolicy

object (DisabledPolicy)

Se inhabilitó la política para usar.

languageCode

string

El código de idioma BCP-47 que se usará para evaluar las etiquetas de los campos localizados. Si no se especifica, se usarán los valores en el 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.