Method: files.modifyLabels

Modifica il set di etichette applicate a un file. Restituisce un elenco delle etichette aggiunte o modificate.

Richiesta HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/modifyLabels

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
fileId

string

L'ID del file a cui appartengono le etichette.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di ModifyLabelsRequest.

Corpo della risposta

Risposta a una richiesta files.modifyLabels. Contiene solo le etichette aggiunte o aggiornate dalla richiesta.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
Campi
modifiedLabels[]

object (Label)

L'elenco delle etichette aggiunte o aggiornate dalla richiesta.
kind

string

Questo è sempre drive#modifyLabelsResponse

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

Alcuni ambiti sono soggetti a restrizioni e richiedono una valutazione della sicurezza per poter essere utilizzati dalla tua app. Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ModifyLabelsRequest

Una richiesta di modifica dell'insieme di etichette di un file. Questa richiesta potrebbe contenere molte modifiche che avranno esito positivo o negativo in modo atomico.

Rappresentazione JSON 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
Campi
labelModifications[]

object (LabelModification)

L'elenco delle modifiche da applicare alle etichette del file.
kind

string

Questo è sempre drive#modifyLabelsRequest.

LabelModification

Modifica di un'etichetta su un file. Un oggetto LabelModification può essere utilizzato per applicare un'etichetta a un file, aggiornare un'etichetta esistente su un file o rimuovere un'etichetta da un file.

Rappresentazione JSON 
{
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "labelId": string,
  "removeLabel": boolean,
  "kind": string
}
Campi
fieldModifications[]

object (FieldModification)

L'elenco delle modifiche ai campi di questa etichetta.
labelId

string

L'ID dell'etichetta da modificare.
removeLabel

boolean

Se true, l'etichetta verrà rimossa dal file.
kind

string

Questo è sempre drive#labelModification.

FieldModification

Modifica di un campo di un'etichetta.

Rappresentazione JSON 
{
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "fieldId": string,
  "kind": string,
  "unsetValues": boolean
}
Campi
setDateValues[]

string

Sostituisce il valore di un campo date con questi nuovi valori. La stringa deve essere nel formato di data completa RFC 3339: AAAA-MM-GG.
setTextValues[]

string

Imposta il valore di un campo text.
setSelectionValues[]

string

Sostituisce un campo selection con questi nuovi valori.
setIntegerValues[]

string (int64 format)

Sostituisce il valore di un campo integer con questi nuovi valori.
setUserValues[]

string

Sostituisce un campo user con questi nuovi valori. I valori devono essere indirizzi email validi.
fieldId

string

L'ID del campo da modificare.
kind

string

Questo valore è sempre drive#labelFieldModification.
unsetValues

boolean

Annulla i valori per questo campo.