Method: labels.disable

Disattivare un'etichetta pubblicata. La disattivazione di un'etichetta comporterà la creazione di una nuova revisione pubblicata disattivata in base alla revisione pubblicata corrente. Se esiste una revisione della bozza, verrà creata una nuova revisione della bozza disattivata in base all'ultima revisione della bozza. Le revisioni delle bozze precedenti verranno eliminate.

Una volta disattivata, un'etichetta può essere eliminata con labels.delete.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome della risorsa dell'etichetta.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
Campi
updateMask

string (FieldMask format)

I campi che devono essere aggiornati. È necessario specificare almeno un campo. La radice disabledPolicy è implicita e non deve essere specificata. Un singolo * può essere utilizzato come scorciatoia per aggiornare ogni campo.
useAdminAccess

boolean

Impostato su true per utilizzare le credenziali di amministrazione dell'utente. Il server verificherà che l'utente sia un amministratore dell'etichetta prima di consentire l'accesso.
writeControl

object (WriteControl)

Fornisce il controllo sulla modalità di esecuzione delle richieste di scrittura. Il valore predefinito è unset, il che significa che vince l'ultima scrittura.
disabledPolicy

object (DisabledPolicy)

Criterio disattivato da utilizzare.
languageCode

string

Il codice lingua BCP-47 da utilizzare per la valutazione delle etichette dei campi localizzate. Se non specificato, verranno utilizzati i valori nella lingua configurata predefinita.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Label.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

Per ulteriori informazioni, consulta la Guida all'autorizzazione.