Method: labels.disable

Desativar um marcador publicado. A desativação de um marcador resultará na desativação de uma nova revisão publicada com base na revisão publicada atual. Se houver uma revisão de rascunho, uma nova revisão de rascunho desativada será criada com base na revisão de rascunho mais recente. As revisões de rascunho mais antigas serão excluídas.

Quando desativado, um marcador 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 de 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 serão atualizados. É necessário especificar pelo menos um campo. A raiz disabledPolicy está implícita e não deve ser especificada. Um único * pode ser usado como abreviação para atualizar cada campo.
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.
disabledPolicy

object (DisabledPolicy)

Política de uso desativada.
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.