- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ModifyLabelsRequest
- LabelModification
- FieldModification
- Prova!
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 |
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 ( |
Campi | |
---|---|
modifiedLabels[] |
L'elenco di etichette che sono state aggiunte o aggiornate dalla richiesta. |
kind |
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 ( |
Campi | |
---|---|
labelModifications[] |
L'elenco delle modifiche da applicare alle etichette nel file. |
kind |
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 ( |
Campi | |
---|---|
labelId |
L'ID dell'etichetta da modificare. |
fieldModifications[] |
L'elenco delle modifiche ai campi di questa etichetta. |
removeLabel |
Se il valore è true, l'etichetta verrà rimossa dal file. |
kind |
È 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 |
L'ID del campo da modificare. |
kind |
È sempre drive#labelFieldModification. |
setDateValues[] |
Sostituisce il valore di un campo |
setTextValues[] |
Imposta il valore di un campo |
setSelectionValues[] |
Sostituisce un campo |
setIntegerValues[] |
Sostituisce il valore di un campo |
setUserValues[] |
Sostituisce un campo |
unsetValues |
Annulla l'impostazione dei valori per questo campo. |