Method: labels.disable

Disattivare un'etichetta pubblicata. Per ulteriori informazioni, vedi Disattivare, attivare ed eliminare un'etichetta.

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

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

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome della risorsa 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 da aggiornare. È necessario specificare almeno un campo. La radice disabledPolicy è implicita e non deve essere specificata. Un singolo * può essere utilizzato come abbreviazione per aggiornare ogni campo.

useAdminAccess

boolean

Imposta su true per utilizzare le credenziali di amministratore dell'utente. Prima di consentire l'accesso, il server verificherà che l'utente sia un amministratore dell'etichetta.

writeControl

object (WriteControl)

Fornisce il controllo sulla modalità di esecuzione delle richieste di scrittura. Il valore predefinito è non impostato, il che significa che l'ultima scrittura ha la precedenza.

disabledPolicy

object (DisabledPolicy)

Criterio disattivato da utilizzare.

languageCode

string

Il codice lingua BCP-47 da utilizzare per valutare le etichette dei campi localizzate. Se non specificati, vengono utilizzati i valori nella lingua predefinita configurata.

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.