Method: labels.disable

Wyłączanie opublikowanej etykiety. Wyłączenie etykiety spowoduje opublikowanie nowej wersji z wyłączoną etykietą na podstawie bieżącej opublikowanej wersji. Jeśli istnieje wersja robocza, na podstawie najnowszej wersji roboczej zostanie utworzona nowa wersja robocza z wyłączoną możliwością edycji. Starsze wersje robocze zostaną usunięte.

Po wyłączeniu etykiety można ją usunąć za pomocą labels.delete.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. 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. Element disabledPolicy jest elementem nadrzędnym, którego nie trzeba deklarować. Jako skrót do aktualizowania wszystkich pól możesz użyć pojedynczego znaku *.

useAdminAccess

boolean

Ustaw na true, aby używać danych logowania administratora użytkownika. Zanim zezwoli na dostęp, serwer sprawdzi, czy użytkownik jest administratorem etykiety.

writeControl

object (WriteControl)

Umożliwia kontrolowanie sposobu wykonywania żądań zapisu. Domyślnie jest to wartość nieskonfigurowana, co oznacza, że zwycięża ostatnia wartość zapisana.

disabledPolicy

object (DisabledPolicy)

Wyłączona zasada do użycia.

languageCode

string

Kod języka BCP-47 używany do oceny zlokalizowanych etykiet pól. Jeśli nie podasz wartości, zostaną użyte wartości w domyślnym 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.