Method: labels.disable

Desativar um marcador publicado. Para mais informações, consulte Desativar, ativar e excluir um rótulo.

A desativação de um rótulo resulta em uma nova revisão publicada desativada com base na revisão publicada atual. Se houver um rascunho de revisão, um novo rascunho desativado será criado com base no rascunho mais recente. As revisões de rascunho mais antigas serão excluídas.

Depois de desativado, um rótulo pode ser excluído com labels.delete.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
name

string

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

Corpo da solicitação

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

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

string (FieldMask format)

Os campos que precisam ser atualizados. É necessário especificar pelo menos um campo. A raiz disabledPolicy está implícita e não precisa ser especificada. Um único * pode ser usado como um atalho para atualizar todos os campos.
useAdminAccess

boolean

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

object (WriteControl)

Oferece controle sobre como as solicitações de gravação são executadas. O padrão é "não definido", o que significa que a gravação mais recente prevalece.
disabledPolicy

object (DisabledPolicy)

Política desativada para uso.
languageCode

string

O código de idioma BCP-47 a ser usado para avaliar rótulos de campo localizados. Quando não especificados, os valores no idioma padrão configurado serã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 do 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.