Method: labels.disable
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyłącz opublikowaną etykietę. Więcej informacji znajdziesz w artykule Wyłączanie, włączanie i usuwanie etykiety.
Wyłączenie etykiety spowoduje utworzenie nowej wyłączonej opublikowanej wersji na podstawie bieżącej opublikowanej wersji. Jeśli istnieje wersja robocza, na jej podstawie zostanie utworzona nowa wyłączona wersja robocza. Starsze wersje robocze zostaną usunięte.
Po wyłączeniu etykietę można usunąć za pomocą ikony labels.delete
.
Żądanie HTTP
POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry |
name |
string
Wymagany. Nazwa zasobu etykiety.
|
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
{
"updateMask": string,
"useAdminAccess": boolean,
"writeControl": {
object (WriteControl )
},
"disabledPolicy": {
object (DisabledPolicy )
},
"languageCode": string
} |
Pola |
updateMask |
string (FieldMask format)
Pola, które należy zaktualizować. Musisz określić co najmniej 1 pole. Katalog główny disabledPolicy jest domyślny i nie należy go określać. Pojedynczy znak * może służyć jako skrót do aktualizowania wszystkich pól.
|
useAdminAccess |
boolean
Ustaw wartość true , aby używać danych logowania administratora użytkownika. Przed przyznaniem dostępu serwer sprawdzi, czy użytkownik jest administratorem etykiety.
|
writeControl |
object (WriteControl )
Umożliwia kontrolowanie sposobu wykonywania żądań zapisu. Domyślnie jest to wartość nieustawiona, co oznacza, że wygrywa ostatni zapis.
|
disabledPolicy |
object (DisabledPolicy )
Wyłączone zasady do użycia.
|
languageCode |
string
Kod języka w formacie BCP-47, który ma być używany do oceny zlokalizowanych etykiet pól. Jeśli nie zostanie określony, użyte zostaną wartości w domyślnie skonfigurowanym języku.
|
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Label
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
Więcej informacji znajdziesz w przewodniku po autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-05 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]