Method: files.modifyLabels

Modifica l'insieme di etichette applicate a un file. Restituisce un elenco delle etichette aggiunte o modificate.

Richiesta HTTP

POST https://www.googleapis.com/drive/v2/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 valore è 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 limitati e richiedono una valutazione di 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 può contenere molte modifiche che avranno tutte esito positivo o tutte 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 valore è sempre drive#modifyLabelsRequest.

LabelModification

Una modifica a un'etichetta in un file. Un'etichetta di modifica può essere utilizzata per applicare un'etichetta a un file, aggiornare un'etichetta esistente in un file o rimuovere un'etichetta da un file.

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

string

L'ID dell'etichetta da modificare.
fieldModifications[]

object (FieldModification)

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

boolean

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

string

Questo valore è sempre drive#labelModification.

FieldModification

Una modifica al campo di un'etichetta.

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

string

L'ID del campo da modificare.
kind

string

Questo valore è sempre drive#labelFieldModification.
setDateValues[]

string

Sostituisce il valore di un campo date con questi nuovi valori. La stringa deve essere nel formato della 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.
unsetValues

boolean

Reimposta i valori per questo campo.