Method: files.modifyLabels

Modifie l'ensemble des libellés appliqués à un fichier. Renvoie la liste des libellés qui ont été ajoutés ou modifiés.

Requête HTTP :

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

ID du fichier auquel appartiennent les libellés.

Corps de la requête

Le corps de la requête contient une instance ModifyLabelsRequest.

Corps de la réponse

Réponse à une requête files.modifierLabels. Elle ne contient que les libellés ajoutés ou mis à jour par la requête.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
Champs
modifiedLabels[]

object (Label)

Liste des libellés ajoutés ou mis à jour par la requête.
kind

string

Il s'agit toujours de Drive#modifierLabelsResponse.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Certains champs d'application sont limités et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide sur les autorisations.

EditLabelsRequest

Requête de modification de l'ensemble des libellés pour un fichier. Cette requête peut contenir de nombreuses modifications qui réussiront toutes ou échoueront de manière atomique.

Représentation JSON 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
Champs
labelModifications[]

object (LabelModification)

Liste des modifications à appliquer aux libellés du fichier.
kind

string

Il s'agit toujours drive#modificationLabelsRequest.

Modification de l'étiquette

Modification d'un libellé sur un fichier. Une étiquette de modification permet d'appliquer un libellé à un fichier, de modifier un libellé existant sur un fichier ou de supprimer un libellé d'un fichier.

Représentation JSON 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
Champs
labelId

string

Identifiant du libellé à modifier.
fieldModifications[]

object (FieldModification)

Liste des modifications apportées aux champs de ce libellé.
removeLabel

boolean

Si la valeur est définie sur "true", le libellé est supprimé du fichier.
kind

string

Il s'agit toujours de drive#labelModification.

Modification des champs

Modification d'un champ d'un libellé.

Représentation JSON 
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
Champs
fieldId

string

Identifiant du champ à modifier.
kind

string

Il s'agit toujours de Drive#labelFieldModification.
setDateValues[]

string

Remplace la valeur d'un champ date par ces nouvelles valeurs. La chaîne doit être au format complet de RFC 3339: AAAA-MM-JJ.
setTextValues[]

string

Définit la valeur d'un champ text.
setSelectionValues[]

string

Remplace un champ selection par ces nouvelles valeurs.
setIntegerValues[]

string (int64 format)

Remplace la valeur d'un champ integer par ces nouvelles valeurs.
setUserValues[]

string

Remplace un champ user par ces nouvelles valeurs. Les valeurs doivent être des adresses e-mail valides.
unsetValues

boolean

Définit les valeurs de ce champ.