La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
Métadonnées d'un fichier.
{ "kind": "drive#file", "id": string, "name": string, "mimeType": string, "description": string, "starred": boolean, "trashed": boolean, "explicitlyTrashed": boolean, "trashingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "trashedTime": datetime, "parents": [ string ], "properties": { (key): string }, "appProperties": { (key): string }, "spaces": [ string ], "version": long, "webContentLink": string, "webViewLink": string, "iconLink": string, "hasThumbnail": boolean, "thumbnailLink": string, "thumbnailVersion": long, "viewedByMe": boolean, "viewedByMeTime": datetime, "createdTime": datetime, "modifiedTime": datetime, "modifiedByMeTime": datetime, "modifiedByMe": boolean, "sharedWithMeTime": datetime, "sharingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "owners": [ { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string } ], "teamDriveId": string, "driveId": string, "lastModifyingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "shared": boolean, "ownedByMe": boolean, "capabilities": { "canAcceptOwnership": boolean, "canAddChildren": boolean, "canAddFolderFromAnotherDrive": boolean, "canAddMyDriveParent": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canChangeSecurityUpdateEnabled": boolean, "canChangeViewersCanCopyContent": boolean, "canComment": boolean, "canCopy": boolean, "canDelete": boolean, "canDeleteChildren": boolean, "canDownload": boolean, "canEdit": boolean, "canListChildren": boolean, "canModifyContent": boolean, "canModifyContentRestriction": boolean, "canModifyLabels": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenOutOfDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canMoveChildrenWithinDrive": boolean, "canMoveItemIntoTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canMoveItemOutOfDrive": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemWithinDrive": boolean, "canMoveTeamDriveItem": boolean, "canReadLabels": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canReadDrive": boolean, "canRemoveChildren": boolean, "canRemoveMyDriveParent": boolean, "canRename": boolean, "canShare": boolean, "canTrash": boolean, "canTrashChildren": boolean, "canUntrash": boolean }, "viewersCanCopyContent": boolean, "copyRequiresWriterPermission": boolean, "writersCanShare": boolean, "permissions": [ permissions Resource ], "permissionIds": [ string ], "hasAugmentedPermissions": boolean, "folderColorRgb": string, "originalFilename": string, "fullFileExtension": string, "fileExtension": string, "md5Checksum": string, "sha1Checksum": string, "sha256Checksum": string, "size": long, "quotaBytesUsed": long, "headRevisionId": string, "contentHints": { "thumbnail": { "image": bytes, "mimeType": string }, "indexableText": string }, "imageMediaMetadata": { "width": integer, "height": integer, "rotation": integer, "location": { "latitude": double, "longitude": double, "altitude": double }, "time": string, "cameraMake": string, "cameraModel": string, "exposureTime": float, "aperture": float, "flashUsed": boolean, "focalLength": float, "isoSpeed": integer, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "exposureBias": float, "maxApertureValue": float, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": long }, "isAppAuthorized": boolean, "exportLinks": { (key): string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "contentRestrictions": [ { "readOnly": boolean, "reason": string, "restrictingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "restrictionTime": datetime, "type": string } ], "labelInfo": { "labels": [ { "kind": "drive#label", "id": string, "revisionId": string, "fields": { (key): { "kind": "drive#labelField", "id": string, "valueType": string, "dateString": [ date ], "integer": [ long ], "selection": [ string ], "text": [ string ], "user": [ { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string } ] } } } ] }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean } }
Nom de propriété | Valeur | Description | Remarques |
---|---|---|---|
kind |
string |
Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#file" . |
|
id |
string |
ID du fichier. | accessible en écriture |
name |
string |
Nom du fichier. Cela n'est pas nécessairement unique dans un dossier. Notez que pour les éléments immuables tels que les dossiers racines des Drive partagés, le dossier racine Mon Drive et le dossier "Données d'application", le nom est constant. | accessible en écriture |
mimeType |
string |
Type MIME du fichier. Si aucune valeur n'est fournie, Google Drive tente de détecter automatiquement la valeur appropriée du contenu importé. La valeur ne peut être modifiée que si une nouvelle révision est importée. Si un fichier est créé avec un type MIME Google Docs, le contenu importé est importé, si possible. Les formats d'importation compatibles sont publiés dans la ressource "À propos". |
accessible en écriture |
description |
string |
Brève description du fichier. | accessible en écriture |
starred |
boolean |
Indique si l'utilisateur a activé le suivi du fichier. | accessible en écriture |
trashed |
boolean |
Indique si le fichier a été placé dans la corbeille, que ce soit explicitement ou à partir d'un dossier parent placé dans la corbeille. Seul le propriétaire peut placer un fichier dans la corbeille. L'élément placé dans la corbeille est exclu de toutes les réponses files.list renvoyées pour les utilisateurs qui ne sont pas propriétaires du fichier. Toutefois, tous les utilisateurs ayant accès au fichier peuvent voir les métadonnées des éléments placés dans la corbeille dans une réponse de l'API. Tous les utilisateurs disposant d'un accès peuvent copier, télécharger, exporter et partager le fichier. | accessible en écriture |
explicitlyTrashed |
boolean |
Indique si le fichier a été explicitement placé dans la corbeille, et non de manière récursive dans un dossier parent. | |
parents[] |
list |
ID des dossiers parents contenant le fichier. S'il n'est pas spécifié comme faisant partie d'une demande de création, le fichier sera placé directement dans le dossier Mon Drive de l'utilisateur. S'il n'est pas spécifié dans une demande de copie, le fichier hérite des parents visibles du fichier source. Les requêtes de mise à jour doivent utiliser les paramètres |
accessible en écriture |
properties |
object |
Ensemble de paires clé-valeur arbitraires visibles par toutes les applications. Les entrées avec des valeurs NULL sont effacées dans les requêtes de mise à jour et de copie. |
accessible en écriture |
properties.(key) |
string |
||
appProperties |
object |
Ensemble de paires clé/valeur arbitraires qui sont privées de l'application à l'origine de la demande. Les entrées avec des valeurs NULL sont effacées dans les requêtes de mise à jour et de copie. Ces propriétés ne peuvent être récupérées qu'à l'aide d'une requête authentifiée. Une requête authentifiée utilise un jeton d'accès obtenu avec un ID client OAuth 2. Vous ne pouvez pas utiliser de clé API pour récupérer des propriétés privées. |
accessible en écriture |
appProperties.(key) |
string |
||
spaces[] |
list |
Liste des espaces contenant le fichier. Les valeurs actuellement acceptées sont "drive", "appDataFolder" et "photos". | |
version |
long |
Numéro de version qui augmente de façon monotone pour le fichier. Cela reflète chaque modification apportée au fichier sur le serveur, même celles qui ne sont pas visibles par l'utilisateur. | |
webContentLink |
string |
Lien permettant de télécharger le contenu du fichier dans un navigateur. Cette option n'est disponible que pour les fichiers à contenu binaire dans Google Drive. | |
webViewLink |
string |
Lien permettant d'ouvrir le fichier dans un éditeur ou un lecteur Google pertinent dans un navigateur. | |
iconLink |
string |
Lien statique non authentifié vers l'icône du fichier. | |
thumbnailLink |
string |
Lien temporaire vers la vignette du fichier, si disponible. Elles durent généralement quelques heures. Valeur renseignée uniquement lorsque l'application à l'origine de la demande peut accéder au contenu du fichier. Si le fichier n'est pas partagé publiquement, l'URL renvoyée dans Files.thumbnailLink doit être explorée à l'aide d'une requête avec identifiants. |
|
viewedByMe |
boolean |
Indique si le fichier a été consulté par cet utilisateur. | |
viewedByMeTime |
datetime |
Heure de la dernière consultation du fichier par l'utilisateur (date et heure RFC 3339). | accessible en écriture |
createdTime |
datetime |
Date et heure auxquelles le fichier a été créé (date et heure RFC 3339). | accessible en écriture |
modifiedTime |
datetime |
Heure de la dernière modification du fichier par n'importe quel utilisateur (date et heure RFC 3339). Notez que la modification de l'élément "timeTime" a également pour effet de mettre à jour l'élément "modificationByMeTime" de l'utilisateur. |
accessible en écriture |
modifiedByMeTime |
datetime |
Heure de la dernière modification du fichier par l'utilisateur (date et heure RFC 3339). | |
sharedWithMeTime |
datetime |
Heure à laquelle le fichier a été partagé avec l'utilisateur, le cas échéant (heure RFC 3339). | |
sharingUser |
nested object |
Utilisateur ayant partagé le fichier avec l'utilisateur à l'origine de la demande, le cas échéant. | |
sharingUser.kind |
string |
Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user" . |
|
sharingUser.displayName |
string |
Nom à afficher en texte brut pour cet utilisateur. | |
sharingUser.photoLink |
string |
Lien vers la photo de profil de l'utilisateur, si disponible. | |
sharingUser.me |
boolean |
Indique si cet utilisateur est l'utilisateur à l'origine de la demande. | |
sharingUser.permissionId |
string |
ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation. | |
sharingUser.emailAddress |
string |
Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur. | |
owners[] |
list |
Propriétaire de ce fichier. Seuls certains anciens fichiers peuvent avoir plusieurs propriétaires. Ce champ n'est pas renseigné pour les éléments des Drive partagés. | |
owners[].kind |
string |
Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user" . |
|
owners[].displayName |
string |
Nom à afficher en texte brut pour cet utilisateur. | |
owners[].photoLink |
string |
Lien vers la photo de profil de l'utilisateur, si disponible. | |
owners[].me |
boolean |
Indique si cet utilisateur est l'utilisateur à l'origine de la demande. | |
owners[].permissionId |
string |
ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation. | |
owners[].emailAddress |
string |
Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur. | |
lastModifyingUser |
nested object |
Dernier utilisateur à modifier le fichier. | |
lastModifyingUser.kind |
string |
Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user" . |
|
lastModifyingUser.displayName |
string |
Nom à afficher en texte brut pour cet utilisateur. | |
lastModifyingUser.photoLink |
string |
Lien vers la photo de profil de l'utilisateur, si disponible. | |
lastModifyingUser.me |
boolean |
Indique si cet utilisateur est l'utilisateur à l'origine de la demande. | |
lastModifyingUser.permissionId |
string |
ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation. | |
lastModifyingUser.emailAddress |
string |
Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur. | |
shared |
boolean |
Indique si le fichier a été partagé. Non renseigné pour les éléments des Drive partagés. | |
ownedByMe |
boolean |
Indique si l'utilisateur est propriétaire du fichier. Non renseigné pour les éléments des Drive partagés. | |
viewersCanCopyContent |
boolean |
Obsolète. Utilisez plutôt copyRequiresWriterPermission . |
|
writersCanShare |
boolean |
Indique si les utilisateurs disposant uniquement de l'autorisation writer peuvent modifier les autorisations du fichier. Non renseigné pour les éléments des Drive partagés. |
accessible en écriture |
permissions[] |
list |
Liste complète des autorisations pour le fichier. Cette option n'est disponible que si l'utilisateur à l'origine de la demande peut partager le fichier. Non renseigné pour les éléments des Drive partagés. | |
folderColorRgb |
string |
Couleur d'un dossier ou d'un raccourci vers un dossier sous forme de chaîne hexadécimale RVB. Les couleurs compatibles sont publiées dans le champ folderColorPalette de la ressource "À propos". Si une couleur non acceptée est spécifiée, la couleur la plus proche dans la palette sera utilisée à la place. |
accessible en écriture |
originalFilename |
string |
Nom de fichier d'origine du contenu importé (si disponible) ou valeur d'origine du champ name . Cette option n'est disponible que pour les fichiers à contenu binaire dans Google Drive. |
accessible en écriture |
fullFileExtension |
string |
Extension de fichier complète extraite du champ name . Peut contenir plusieurs extensions concaténées, telles que "tar.gz". Cette option n'est disponible que pour les fichiers à contenu binaire dans Google Drive. Ce champ est automatiquement mis à jour en cas de modification du champ |
|
fileExtension |
string |
Dernier composant de fullFileExtension . Cette option n'est disponible que pour les fichiers à contenu binaire dans Google Drive. |
|
md5Checksum |
string |
Somme de contrôle MD5 du contenu du fichier. Cela ne concerne que les fichiers au contenu binaire dans Google Drive. | |
size |
long |
Taille du contenu du fichier en octets. Ce champ est renseigné pour les fichiers au contenu binaire stockés dans Google Drive et pour les fichiers des éditeurs Docs. Il ne l'est pas pour les raccourcis ni pour les dossiers. | |
quotaBytesUsed |
long |
Nombre d'octets de quota de stockage utilisés par le fichier. Cela inclut la révision principale et les révisions précédentes pour lesquelles keepForever est activé. |
|
headRevisionId |
string |
ID de la révision principale du fichier. Actuellement, cette fonctionnalité n'est disponible que pour les fichiers à contenu binaire dans Google Drive. | |
contentHints |
object |
Informations supplémentaires sur le contenu du fichier. Ces champs ne sont jamais renseignés dans les réponses. | |
contentHints.thumbnail |
object |
Vignette du fichier. Elle ne sera utilisée que si Google Drive ne peut pas générer de vignette standard. | |
contentHints.thumbnail.image |
bytes |
Données de vignette encodées en base64 sans risque pour les URL (section 5 de la norme RFC 4648). | accessible en écriture |
contentHints.thumbnail.mimeType |
string |
Type MIME de la vignette. | accessible en écriture |
contentHints.indexableText |
string |
Texte à indexer pour le fichier afin d'améliorer les requêtes fullText. La taille est limitée à 128 Ko et peut contenir des éléments HTML. Pour en savoir plus, consultez Gérer les métadonnées de fichiers. | accessible en écriture |
imageMediaMetadata |
object |
Métadonnées supplémentaires sur les médias image, si disponibles. | |
imageMediaMetadata.width |
integer |
Largeur de l'image en pixels. | |
imageMediaMetadata.height |
integer |
Hauteur de l'image en pixels. | |
imageMediaMetadata.rotation |
integer |
Nombre de rotations de 90° vers la droite appliquées à partir de l'orientation de l'image d'origine. | |
imageMediaMetadata.location |
object |
Informations de géolocalisation stockées dans l'image. | |
imageMediaMetadata.location.latitude |
double |
Latitude stockée dans l'image. | |
imageMediaMetadata.location.longitude |
double |
Longitude stockée dans l'image. | |
imageMediaMetadata.location.altitude |
double |
Altitude stockée dans l'image. | |
imageMediaMetadata.time |
string |
Date et heure de la photo (EXIF DateTime). | |
imageMediaMetadata.cameraMake |
string |
Marque de l'appareil photo utilisé pour créer la photo. | |
imageMediaMetadata.cameraModel |
string |
Modèle de l'appareil photo utilisé pour créer la photo. | |
imageMediaMetadata.exposureTime |
float |
Durée de l'exposition, en secondes. | |
imageMediaMetadata.aperture |
float |
Ouverture utilisée pour créer la photo (f-number). | |
imageMediaMetadata.flashUsed |
boolean |
Indique si un flash a été utilisé pour créer la photo. | |
imageMediaMetadata.focalLength |
float |
Longueur focale utilisée pour créer la photo, en millimètres. | |
imageMediaMetadata.isoSpeed |
integer |
Vitesse ISO utilisée pour créer la photo. | |
imageMediaMetadata.meteringMode |
string |
Mode de mesure utilisé pour créer la photo. | |
imageMediaMetadata.sensor |
string |
Type de capteur utilisé pour créer la photo. | |
imageMediaMetadata.exposureMode |
string |
Mode d'exposition utilisé pour créer la photo. | |
imageMediaMetadata.colorSpace |
string |
Espace colorimétrique de la photo. | |
imageMediaMetadata.whiteBalance |
string |
Mode de balance des blancs utilisé pour créer la photo. | |
imageMediaMetadata.exposureBias |
float |
Biais d'exposition de la photo (valeur EXEX). | |
imageMediaMetadata.maxApertureValue |
float |
Plus petit nombre f de l'objectif à la distance focale utilisée pour créer la photo (valeur EXEX). | |
imageMediaMetadata.subjectDistance |
integer |
Distance par rapport au sujet de la photo, en mètres. | |
imageMediaMetadata.lens |
string |
Objectif utilisé pour créer la photo. | |
videoMediaMetadata |
object |
Métadonnées supplémentaires sur les médias vidéo. Cette fonctionnalité peut ne pas être disponible immédiatement après l'importation. | |
videoMediaMetadata.width |
integer |
Largeur de la vidéo, en pixels. | |
videoMediaMetadata.height |
integer |
Hauteur de la vidéo, en pixels. | |
videoMediaMetadata.durationMillis |
long |
Durée de la vidéo en millisecondes. | |
capabilities |
object |
Fonctionnalités dont dispose l'utilisateur actuel sur ce fichier. Chaque capacité correspond à une action précise qu'un utilisateur peut effectuer. | |
capabilities.canEdit |
boolean |
Indique si l'utilisateur actuel peut modifier ce fichier. D'autres facteurs peuvent limiter le type de modifications qu'un utilisateur peut apporter au fichier. Par exemple, consultez canChangeCopyRequiresWriterPermission ou canModifyContent . |
|
capabilities.canComment |
boolean |
Indique si l'utilisateur actuel peut ajouter des commentaires à ce fichier. | |
capabilities.canShare |
boolean |
Indique si l'utilisateur actuel peut modifier les paramètres de partage de ce fichier. | |
capabilities.canCopy |
boolean |
Indique si l'utilisateur actuel peut copier ce fichier. Pour un élément dans un Drive partagé, que l'utilisateur actuel puisse copier les descendants hors dossier de cet élément, ou cet élément lui-même s'il ne s'agit pas d'un dossier. | |
capabilities.canReadRevisions |
boolean |
Indique si l'utilisateur actuel peut lire la ressource des révisions de ce fichier. Pour un élément de Drive partagé, il est possible de lire les révisions des descendants hors de cet élément, ou cet élément s'il ne s'agit pas d'un dossier. | |
isAppAuthorized |
boolean |
Indique si le fichier a été créé ou ouvert par l'application à l'origine de la demande. | |
hasThumbnail |
boolean |
Indique si ce fichier comporte une vignette. Cela n'indique pas si l'application à l'origine de la demande a accès à la vignette. Pour vérifier l'accès, recherchez la présence du champ "thumbnailLink". | |
thumbnailVersion |
long |
Version de vignette à utiliser en cas d'invalidation de cache de vignettes. | |
modifiedByMe |
boolean |
Indique si l'utilisateur a modifié le fichier. | |
trashingUser |
nested object |
Si le fichier a été explicitement placé dans la corbeille, l'utilisateur qui l'a placé dans la corbeille. Renseigné uniquement pour les éléments des Drive partagés. | |
trashingUser.kind |
string |
Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user" . |
|
trashingUser.displayName |
string |
Nom à afficher en texte brut pour cet utilisateur. | |
trashingUser.photoLink |
string |
Lien vers la photo de profil de l'utilisateur, si disponible. | |
trashingUser.me |
boolean |
Indique si cet utilisateur est l'utilisateur à l'origine de la demande. | |
trashingUser.permissionId |
string |
ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation. | |
trashingUser.emailAddress |
string |
Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur. | |
trashedTime |
datetime |
Date et heure auxquelles l'élément a été placé dans la corbeille (date et heure RFC 3339). Renseigné uniquement pour les éléments des Drive partagés. | |
teamDriveId |
string |
Obsolète. Utilisez plutôt driveId . |
|
capabilities.canAddChildren |
boolean |
Indique si l'utilisateur actuel peut ajouter des enfants à ce dossier. La valeur est toujours "false" lorsque l'élément n'est pas un dossier. | |
capabilities.canDelete |
boolean |
Indique si l'utilisateur actuel peut supprimer ce fichier. | |
capabilities.canDownload |
boolean |
Indique si l'utilisateur actuel peut télécharger ce fichier. | |
capabilities.canListChildren |
boolean |
Indique si l'utilisateur actuel peut répertorier les enfants de ce dossier. La valeur est toujours "false" lorsque l'élément n'est pas un dossier. | |
capabilities.canMoveTeamDriveItem |
boolean |
Obsolète. Utilisez plutôt canMoveItemWithinDrive ou canMoveItemOutOfDrive . |
|
capabilities.canMoveItemIntoTeamDrive |
boolean |
Obsolète. Utilisez plutôt canMoveItemOutOfDrive . |
|
capabilities.canReadTeamDrive |
boolean |
Obsolète. Utilisez plutôt canReadDrive . |
|
capabilities.canRemoveChildren |
boolean |
Indique si l'utilisateur actuel peut supprimer des enfants de ce dossier. La valeur est toujours "false" lorsque l'élément n'est pas un dossier. Pour un dossier dans un Drive partagé, utilisez plutôt canDeleteChildren ou canTrashChildren . |
|
capabilities.canRename |
boolean |
Indique si l'utilisateur actuel peut renommer ce fichier. | |
capabilities.canTrash |
boolean |
Indique si l'utilisateur actuel peut placer ce fichier dans la corbeille. | |
capabilities.canUntrash |
boolean |
Indique si l'utilisateur actuel peut restaurer ce fichier à partir de la corbeille. | |
hasAugmentedPermissions |
boolean |
Indique s'il existe des autorisations directement sur ce fichier. Ce champ n'est renseigné que pour les éléments des Drive partagés. | |
capabilities.canChangeViewersCanCopyContent |
boolean |
Obsolète | |
permissionIds[] |
list |
Liste des ID d'autorisation des utilisateurs ayant accès à ce fichier. | |
capabilities.canChangeCopyRequiresWriterPermission |
boolean |
Indique si l'utilisateur actuel peut modifier la restriction copyRequiresWriterPermission de ce fichier. |
|
copyRequiresWriterPermission |
boolean |
Les options permettant de copier, d'imprimer ou de télécharger ce fichier doivent être désactivées pour les lecteurs et les commentateurs. | accessible en écriture |
capabilities.canDeleteChildren |
boolean |
Indique si l'utilisateur actuel peut supprimer les enfants de ce dossier. La valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés. | |
capabilities.canMoveChildrenOutOfTeamDrive |
boolean |
Obsolète. Utilisez plutôt canMoveChildrenOutOfDrive . |
|
capabilities.canMoveChildrenWithinTeamDrive |
boolean |
Obsolète. Utilisez plutôt canMoveChildrenWithinDrive . |
|
capabilities.canMoveItemOutOfTeamDrive |
boolean |
Obsolète. Utilisez plutôt canMoveItemOutOfDrive . |
|
capabilities.canMoveItemWithinTeamDrive |
boolean |
Obsolète. Utilisez plutôt canMoveItemWithinDrive . |
|
capabilities.canTrashChildren |
boolean |
Indique si l'utilisateur actuel peut placer les enfants de ce dossier dans la corbeille. La valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés. | |
exportLinks |
object |
Liens permettant d'exporter des fichiers d'éditeurs Docs dans des formats spécifiques. | |
exportLinks.(key) |
string |
Mappage entre le format d'exportation et l'URL | |
driveId |
string |
ID du Drive partagé dans lequel se trouve le fichier. Renseigné uniquement pour les éléments des Drive partagés. | |
capabilities.canMoveChildrenOutOfDrive |
boolean |
Indique si l'utilisateur actuel peut déplacer les enfants de ce dossier en dehors du Drive partagé. La valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés. | |
capabilities.canMoveChildrenWithinDrive |
boolean |
Indique si l'utilisateur actuel peut déplacer les enfants de ce dossier dans ce Drive. La valeur est "false" lorsque l'élément n'est pas un dossier. Notez qu'une requête de déplacement de l'enfant peut néanmoins échouer en fonction de l'accès de l'utilisateur actuel à l'enfant et au dossier de destination. | |
capabilities.canMoveItemOutOfDrive |
boolean |
Indique si l'utilisateur actuel peut déplacer cet élément en dehors de ce Drive en modifiant son parent. Notez qu'une demande de modification du parent de l'élément peut toujours échouer en fonction du nouveau parent ajouté. | |
capabilities.canMoveItemWithinDrive |
boolean |
Indique si l'utilisateur actuel peut déplacer cet élément dans ce Drive. Notez qu'une demande de modification du parent de l'élément peut toujours échouer en fonction du nouveau parent ajouté et du parent en cours de suppression. | |
capabilities.canReadDrive |
boolean |
Indique si l'utilisateur actuel peut lire le Drive partagé auquel ce fichier appartient. Renseigné uniquement pour les éléments des Drive partagés. | |
capabilities.canModifyContent |
boolean |
Indique si l'utilisateur actuel peut modifier le contenu de ce fichier. | |
capabilities.canAddMyDriveParent |
boolean |
Indique si l'utilisateur actuel peut ajouter un parent à l'élément sans supprimer de parent dans la même requête. Non renseigné pour les fichiers des Drive partagés. | |
capabilities.canRemoveMyDriveParent |
boolean |
Indique si l'utilisateur actuel peut supprimer un parent de l'élément sans ajouter d'autre parent dans la même demande. Non renseigné pour les fichiers des Drive partagés. | |
shortcutDetails |
object |
Détails du fichier de raccourci. Valeur renseignée uniquement pour les fichiers de raccourci, pour lesquels le champ "mimeType" est défini sur application/vnd.google-apps.shortcut . |
|
shortcutDetails.targetId |
string |
ID du fichier vers lequel pointe ce raccourci. | accessible en écriture |
shortcutDetails.targetMimeType |
string |
Type MIME du fichier vers lequel pointe ce raccourci. La valeur de ce champ est un instantané du type MIME de la cible, capturé lors de la création du raccourci. | |
capabilities.canAddFolderFromAnotherDrive |
boolean |
Indique si l'utilisateur actuel peut ajouter à ce dossier un dossier stocké dans un autre Drive partagé (autre que le Drive partagé ou Mon Drive). La valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés. | |
capabilities.canModifyContentRestriction |
boolean |
Indique si l'utilisateur actuel peut modifier les restrictions sur le contenu de ce fichier. | |
contentRestrictions[] |
list |
Restrictions d'accès au contenu du fichier. Renseigné uniquement si une telle restriction existe. | |
contentRestrictions[].readOnly |
boolean |
Indique si le contenu du fichier est en lecture seule. Si un fichier est en lecture seule, il est impossible d'ajouter une nouvelle révision du fichier, d'ajouter des commentaires ou de modifier le titre du fichier. | accessible en écriture |
contentRestrictions[].reason |
string |
Raison pour laquelle le contenu du fichier est restreint. Cela n'est modifiable que pour les requêtes qui définissent également readOnly=true . |
accessible en écriture |
contentRestrictions[].restrictingUser |
nested object |
Utilisateur ayant défini la restriction de contenu. N'est renseigné que si la valeur de readOnly est "true". |
|
contentRestrictions[].restrictingUser.kind |
string |
Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user" . |
|
contentRestrictions[].restrictingUser.displayName |
string |
Nom à afficher en texte brut pour cet utilisateur. | |
contentRestrictions[].restrictingUser.photoLink |
string |
Lien vers la photo de profil de l'utilisateur, si disponible. | |
contentRestrictions[].restrictingUser.me |
boolean |
Indique si cet utilisateur est l'utilisateur à l'origine de la demande. | |
contentRestrictions[].restrictingUser.permissionId |
string |
ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation. | |
contentRestrictions[].restrictingUser.emailAddress |
string |
Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur. | |
contentRestrictions[].restrictionTime |
datetime |
Date et heure auxquelles la restriction de contenu a été définie (horodatage au format RFC 3339 mis en forme). N'est renseigné que si la valeur de readOnly est "true". |
|
contentRestrictions[].type |
string |
Type de restriction de contenu. Actuellement, la seule valeur possible est globalContentRestriction . |
|
capabilities.canChangeSecurityUpdateEnabled |
boolean |
Indique si l'utilisateur actuel peut modifier le champ securityUpdateEnabled sur les métadonnées de partage par lien. | |
shortcutDetails.targetResourceKey |
string |
Clé de ressource pour le fichier cible. | |
resourceKey |
string |
Une clé est nécessaire pour accéder à l'élément via un lien partagé. | |
linkShareMetadata |
object |
Contient des informations sur les URL des liens que les clients utilisent pour faire référence à cet élément. | |
linkShareMetadata.securityUpdateEligible |
boolean |
Indique si le fichier peut être mis à jour pour la sécurité. | |
linkShareMetadata.securityUpdateEnabled |
boolean |
Indique si la mise à jour de sécurité est activée pour ce fichier. | |
capabilities.canAcceptOwnership |
boolean |
Indique si l'utilisateur actuel est le propriétaire en attente du fichier. Non renseigné pour les fichiers des Drive partagés. | |
capabilities.canModifyLabels |
boolean |
Indique si l'utilisateur actuel peut modifier les libellés de ce fichier. | |
capabilities.canReadLabels |
boolean |
Indique si l'utilisateur actuel peut lire les libellés de ce fichier. | |
labelInfo |
object |
Présentation des libellés du fichier. | |
labelInfo.labels[] |
list |
Ensemble d'étiquettes du fichier, tel que demandé par les ID d'étiquette dans le paramètre includeLabels . Par défaut, aucun libellé n'est renvoyé. |
|
labelInfo.labels[].kind |
string |
Il s'agit toujours de drive#label | |
labelInfo.labels[].id |
string |
ID du libellé. | |
labelInfo.labels[].revisionId |
string |
ID de révision du libellé. | |
labelInfo.labels[].fields |
object |
Carte des champs du libellé associés à l'ID du champ. | |
labelInfo.labels[].fields.(key) |
nested object |
||
labelInfo.labels[].fields.(key).kind |
string |
Il s'agit toujours de drive#labelField. | |
labelInfo.labels[].fields.(key).id |
string |
Identifiant de ce champ. | |
labelInfo.labels[].fields.(key).valueType |
string |
Type de champ. Les nouvelles valeurs pourront être acceptées ultérieurement, mais les suivantes sont actuellement autorisées :
|
|
labelInfo.labels[].fields.(key).dateString[] |
list |
Uniquement présente si valueType est dateString . Date au format RFC 3339: AAAA-MM-JJ. |
|
labelInfo.labels[].fields.(key).integer[] |
list |
Uniquement présente si valueType est integer . |
|
labelInfo.labels[].fields.(key).selection[] |
list |
Uniquement présente si valueType est selection . |
|
labelInfo.labels[].fields.(key).text[] |
list |
Uniquement présente si valueType est text . |
|
labelInfo.labels[].fields.(key).user[] |
list |
Uniquement présente si valueType est user . |
|
labelInfo.labels[].fields.(key).user[].kind |
string |
Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user" . |
|
labelInfo.labels[].fields.(key).user[].displayName |
string |
Nom à afficher en texte brut pour cet utilisateur. | |
labelInfo.labels[].fields.(key).user[].photoLink |
string |
Lien vers la photo de profil de l'utilisateur, si disponible. | |
labelInfo.labels[].fields.(key).user[].me |
boolean |
Indique si cet utilisateur est l'utilisateur à l'origine de la demande. | |
labelInfo.labels[].fields.(key).user[].permissionId |
string |
ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation. | |
labelInfo.labels[].fields.(key).user[].emailAddress |
string |
Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur. | |
sha1Checksum |
string |
Somme de contrôle SHA1 associée à ce fichier, si disponible. Ce champ n'est renseigné que pour des fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs, ni pour les fichiers de raccourci. | |
sha256Checksum |
string |
Somme de contrôle SHA256 associée à ce fichier, si disponible. Ce champ n'est renseigné que pour des fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs, ni pour les fichiers de raccourci. |
Méthodes
- copie
- Crée une copie d'un fichier et applique toutes les mises à jour demandées avec la sémantique "patch". Impossible de copier les dossiers.
- créer
- Crée un fichier.
- supprimer
- Supprime définitivement un fichier appartenant à l'utilisateur sans le placer dans la corbeille. Si le fichier appartient à un Drive partagé, l'utilisateur doit être l'organisateur du parent. Si la cible est un dossier, tous les descendants appartenant à l'utilisateur sont également supprimés.
- Vider la corbeille
- Supprime définitivement tous les fichiers placés dans la corbeille de l'utilisateur.
- exporter
- Exporte un document Google Workspace vers le type MIME demandé et renvoie le contenu d'octets exporté. Notez que le contenu exporté est limité à 10 Mo.
- generateIds
- Génère un ensemble d'ID de fichier qui peuvent être fournis dans des requêtes de création ou de copie.
- obtenir
- Récupère les métadonnées ou le contenu d'un fichier par ID.
- list
- Répertorie ou recherche des fichiers.
- mettre à jour
- Met à jour les métadonnées et/ou le contenu d'un fichier. Lorsque vous appelez cette méthode, ne renseignez que les champs de la requête que vous souhaitez modifier. Lors de la mise à jour de champs, certains champs peuvent changer automatiquement, tels que changedDate. Cette méthode est compatible avec la sémantique "patch".
- montre
- S'abonne aux modifications apportées à un fichier. Vous pouvez définir un canal de distribution pour les modifications apportées à un fichier d'un Drive partagé, mais la modification d'un fichier n'entraîne pas de notification.
- listLabels.
- Répertorie les libellés d'un fichier.
- modifyLabels
- Modifie l'ensemble des libellés d'un fichier.