Method: labels.publish

Pubblica tutte le modifiche alla bozza dell'etichetta. Una volta pubblicata, l'etichetta non può tornare allo stato di bozza. Consulta google.apps.drive.labels.v2.Lifecycle per saperne di più.

La pubblicazione di un'etichetta comporterà la pubblicazione di una nuova revisione. Tutte le bozze precedenti verranno eliminate. Le revisioni pubblicate in precedenza verranno conservate, ma sono soggette a eliminazione automatica, se necessario.

Una volta pubblicate, alcune modifiche non sono più consentite. In genere, qualsiasi modifica che renderebbe invalida o causa nuove restrizioni sui metadati esistenti correlati all'etichetta verrà rifiutata. Ad esempio, le seguenti modifiche a un'etichetta verranno rifiutate dopo la pubblicazione dell'etichetta: * Non è possibile eliminare direttamente l'etichetta. Deve essere prima disabilitata, poi eliminata. * Impossibile modificare Field.FieldType. * Le modifiche apportate alle opzioni di convalida dei campi non possono rifiutare elementi accettati in precedenza. * Riduzione del numero massimo di voci.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

obbligatorio. Etichetta il nome della risorsa.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

boolean

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

object (WriteControl)

Fornisce il controllo su come vengono eseguite le richieste di scrittura. Il valore predefinito è "Non impostato", a indicare che l'ultima scrittura vince.
languageCode

string

Il codice lingua BCP-47 da utilizzare per valutare le etichette dei campi localizzati. Se non specificato, verranno 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.