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.modifyLabel. 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 aggiunte o aggiornate dalla richiesta.
kind

string

È 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 della sicurezza per consentire alla tua app di utilizzarli. Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ModifyLabelsRequest

Richiesta di modifica dell'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 di modifiche da applicare alle etichette sul file.
kind

string

Il valore è sempre drive#modifyLabelsRequest.

LabelModification

Modifica a un'etichetta in un file. È possibile utilizzare LabelModification per applicare un'etichetta a un file, aggiornare un'etichetta esistente su 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 apportate ai campi di questa etichetta.
removeLabel

boolean

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

string

Il valore è sempre drive#labelModification.

FieldModification

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

Il valore è 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

Consente di impostare 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

Consente di annullare l'impostazione dei valori per questo campo.