Method: labels.publish

Publicar todos los cambios en borrador para la etiqueta Una vez publicada, la etiqueta no puede volver 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 todos los borradores anteriores. Se conservarán las revisiones publicadas anteriormente, pero están sujetas a eliminación automática según sea necesario.

Una vez publicados, ya no se permiten algunos cambios. Por lo general, se rechazará cualquier cambio que invalide o genere restricciones nuevas en los metadatos existentes relacionados con la etiqueta. Por ejemplo, se rechazarán los siguientes cambios en una etiqueta luego de que se publique: * La etiqueta no se puede borrar de forma directa. Primero debes inhabilitarla y, luego, borrarla. * No se puede cambiar Field.FieldType. * Los cambios en las opciones de validación de campos no pueden rechazar algo que ya se haya aceptado. * Reducir la cantidad máxima de entradas

Solicitud HTTP

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

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