Method: files.modifyLabels

Modifica l'insieme di etichette applicate a un file. Restituisce un elenco delle etichette che sono state 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 che sono state 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 di etichette che sono state 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 limitati e richiedono una valutazione di sicurezza affinché l'app li utilizzi. Per ulteriori informazioni, consulta la Guida alle autorizzazioni.

ModifyLabelsRequest

Richiesta per modificare l'insieme di etichette in un file. Questa richiesta può contenere molte modifiche che avranno esito positivo o negativo a livello atomico.

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

object (LabelModification)

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

string

Si tratta sempre di drive#modifyLabelsRequest.

LabelModification

Modifica di un'etichetta di un file. È possibile utilizzare un'etichetta Modification per applicare un'etichetta a un file, aggiornare un'etichetta esistente 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 il valore è true, l'etichetta verrà rimossa dal file.
kind

string

È sempre drive#labelModification.

FieldModification

Modifica del 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

È sempre drive#labelFieldModification.
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.
unsetValues

boolean

Annulla l'impostazione dei valori per questo campo.