Method: labels.publish

Publica todos los cambios del borrador en la etiqueta. Una vez que se publique, es posible que la etiqueta no vuelva a su estado de borrador. Consulta google.apps.drive.labels.v2.Lifecycle para obtener más información.

Si publicas una etiqueta, se creará una nueva revisión publicada. Se borrarán todas las revisiones de borradores anteriores. Se conservarán las revisiones publicadas anteriormente, pero están sujetas a eliminación automática según sea necesario.

Una vez que se publican, ya no se permiten algunos cambios. Por lo general, se rechazará cualquier cambio que invalide o cause nuevas restricciones en los metadatos existentes relacionados con la etiqueta. Por ejemplo, los siguientes cambios en una etiqueta se rechazarán después de que se publique: * La etiqueta no se puede borrar directamente. Primero, se debe inhabilitar y, luego, borrar. * No se puede cambiar Field.FieldType. * Los cambios en las opciones de validación de campos no pueden rechazar algo que se aceptó anteriormente. * Reducción de las entradas máximas

Solicitud HTTP

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

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 
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
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.
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.