Method: labels.disable
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-05 UTC.
[null,null,["Última atualização 2025-08-05 UTC."],[],[],null,["# Method: labels.disable\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDisable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label).\n\nDisabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted.\n\nOnce disabled, a label may be deleted with `labels.delete`.\n\n### HTTP request\n\n`POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------|\n| `name` | `string` Required. Label resource name. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"updateMask\": string, \"useAdminAccess\": boolean, \"writeControl\": { object (/workspace/drive/labels/reference/rest/v2/WriteControl) }, \"disabledPolicy\": { object (/workspace/drive/labels/reference/rest/v2/labels#DisabledPolicy) }, \"languageCode\": string } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` The fields that should be updated. At least one field must be specified. The root `disabledPolicy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field. |\n| `useAdminAccess` | `boolean` Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. |\n| `writeControl` | `object (`[WriteControl](/workspace/drive/labels/reference/rest/v2/WriteControl)`)` Provides control over how write requests are executed. Defaults to unset, which means the last write wins. |\n| `disabledPolicy` | `object (`[DisabledPolicy](/workspace/drive/labels/reference/rest/v2/labels#DisabledPolicy)`)` Disabled policy to use. |\n| `languageCode` | `string` The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Label](/workspace/drive/labels/reference/rest/v2/labels#Label).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive.labels`\n- `\n https://www.googleapis.com/auth/drive.admin.labels`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
