- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- ModifyLabelsRequest
- LabelModification
- FieldModification
- Essayer
Modifie l'ensemble des libellés appliqués à un fichier. Renvoie une 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 |
ID du fichier auquel appartiennent les libellés. |
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 libellés ajoutés ou modifiés 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 ( |
Champs | |
---|---|
modifiedLabels[] |
Liste des libellés ajoutés ou modifiés par la requête. |
kind |
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 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 permettant de modifier l'ensemble des 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 ( |
Champs | |
---|---|
labelModifications[] |
Liste des modifications à appliquer aux libellés du fichier. |
kind |
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 |
---|
{
"fieldModifications": [
{
object ( |
Champs | |
---|---|
fieldModifications[] |
Liste des modifications apportées aux champs de ce libellé. |
labelId |
ID du libellé à modifier. |
removeLabel |
Si la valeur est "vrai", le libellé sera supprimé du fichier. |
kind |
Il s'agit toujours de drive#labelModification. |
FieldModification
Modification d'un champ de libellé.
Représentation JSON |
---|
{ "setDateValues": [ string ], "setTextValues": [ string ], "setSelectionValues": [ string ], "setIntegerValues": [ string ], "setUserValues": [ string ], "fieldId": string, "kind": string, "unsetValues": boolean } |
Champs | |
---|---|
setDateValues[] |
Remplace la valeur d'un champ |
setTextValues[] |
Définit la valeur d'un champ |
setSelectionValues[] |
Remplace un champ |
setIntegerValues[] |
Remplace la valeur d'un champ |
setUserValues[] |
Remplace un champ |
fieldId |
ID du champ à modifier. |
kind |
Il s'agit toujours de drive#labelFieldModification. |
unsetValues |
Supprime les valeurs de ce champ. |