Method: labels.publish

Publicar todos los cambios del borrador en la etiqueta. Una vez publicada, 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 publicará una nueva revisión. Se borrarán todas las revisiones de borradores anteriores. Se conservarán las revisiones publicadas anteriores, pero estarán sujetas a eliminación automática según sea necesario.

Una vez publicados, ya no se permiten algunos cambios. En general, se rechazará cualquier cambio que invalide o provoque nuevas restricciones en los metadatos existentes que se relacionen 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 debes inhabilitarlos y, luego, borrarlos. * No se puede cambiar el campo Field.FieldType. * Los cambios en las opciones de validación de Campo no pueden rechazar algo que se aceptó anteriormente. * Reducir la cantidad máxima de entradas

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

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

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.
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.