Method: files.modifyLabels

Modifie l'ensemble de libellés appliqués à un fichier. Affiche la liste des libellés 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 les libellés appartiennent.

Corps de la requête

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

Corps de la réponse

Réponse à une requête files.modifyLabels. Il ne contient que les étiquettes qui ont été ajoutées ou mises à 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#modifyLabelsResponse.

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 soumis à des restrictions et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.

ModifyLabelsRequest

Requête visant à modifier l'ensemble de libellés d'un fichier. Cette requête peut contenir de nombreuses modifications qui réussiront ou échoueront toutes 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 de drive#modifyLabelsRequest.

LabelModification

Modification d'un libellé sur un fichier. Une modification de libellé peut être utilisée pour appliquer un libellé à un fichier, mettre à jour un libellé existant sur un fichier ou supprimer un libellé d'un fichier.

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

string

ID du libellé à modifier.
fieldModifications[]

object (FieldModification)

Liste des modifications apportées aux champs de cette étiquette.
removeLabel

boolean

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

string

Il s'agit toujours de drive#labelModification.

FieldModification

Modification du 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

ID 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 de date complet 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

Réinitialise les valeurs de ce champ.