Method: labels.publish

Publicar todas as mudanças de rascunho no marcador. Depois de publicado, o marcador não pode voltar ao estado de rascunho. Consulte google.apps.drive.labels.v2.Lifecycle para mais informações.

A publicação de um marcador resulta em uma nova revisão publicada. Todas as revisões de rascunho anteriores serão excluídas. As revisões publicadas anteriormente vão ser mantidas, mas estão sujeitas à exclusão automática conforme necessário.

Após a publicação, algumas mudanças não serão mais permitidas. Geralmente, qualquer alteração que invalide ou cause novas restrições nos metadados existentes relacionados ao marcador será rejeitada. Por exemplo, as seguintes alterações em um marcador serão rejeitadas após a publicação dele: * O marcador não pode ser excluído diretamente. Ela precisa ser desativada primeiro e depois excluída. * Field.FieldType não pode ser alterado. * As mudanças nas opções de validação de campo não podem rejeitar algo que já foi aceito. * Redução do número máximo de entradas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Nome do recurso de rótulo.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
Campos
useAdminAccess

boolean

Defina como true para usar as credenciais de administrador do usuário. O servidor verificará se o usuário é um administrador do marcador antes de permitir o acesso.
writeControl

object (WriteControl)

Fornece controle sobre como as solicitações de gravação são executadas. O padrão é "unset", o que significa que a última gravação vence.
languageCode

string

O código de idioma BCP-47 a ser usado para avaliar rótulos de campo localizados. Quando não é especificado, os valores no idioma padrão configurado são usados.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Label.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

Para mais informações, consulte o Guia de autorização.