Method: labels.disable

Inhabilitar una etiqueta publicada Si inhabilitas una etiqueta, se inhabilitará una nueva revisión publicada basada en la versión publicada actual. Si hay una revisión en borrador, se creará una nueva versión inhabilitada en función de la versión de borrador más reciente. Se borrarán las revisiones en borrador 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. Es el 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 * como atajo para actualizar cada campo.
useAdminAccess

boolean

Configúralo como true para usar las credenciales de administrador del usuario. El servidor verificará que el usuario sea un 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 prevalecerá la última escritura.
disabledPolicy

object (DisabledPolicy)

Se inhabilitó el uso de la política.
languageCode

string

Es el código de idioma BCP-47 que se debe usar para evaluar etiquetas de campo localizadas. 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.

Permisos de autorización

Se necesita uno de los siguientes alcances 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.