REST Resource: files

Ressource : File

Métadonnées d'un fichier.

Certaines méthodes de ressources (comme files.update) nécessitent un fileId. Utilisez la méthode files.list pour récupérer l'ID d'un fichier.

Représentation JSON
{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "thumbnail": {
    "image": string,
    "mimeType": string
  },
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "date": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}
Champs
ownerNames[]

string

Uniquement en sortie. Nom(s) du ou des propriétaires de ce fichier. Non renseigné pour les éléments des Drive partagés.

parents[]

object (ParentReference)

ID du dossier parent contenant le fichier.

Un fichier ne peut avoir qu'un seul dossier parent. Il n'est pas possible d'en spécifier plusieurs.

Si ce n'est pas spécifié dans une requête d'insertion, le fichier est 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 de tout parent détectable du fichier source. Les requêtes files.update doivent utiliser les paramètres addParents et removeParents pour modifier la liste des parents.

owners[]

object (User)

Uniquement en sortie. 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 Drives partagés.

properties[]

object (Property)

Liste des propriétés.

permissions[]

object (Permission)

Uniquement en sortie. Liste des autorisations des utilisateurs ayant accès à ce fichier. Non renseigné pour les éléments des Drive partagés.

spaces[]

string

Uniquement en sortie. Liste des espaces contenant le fichier. Les valeurs acceptées sont drive, appDataFolder et photos.

permissionIds[]

string

Sortie uniquement. files.list des ID d'autorisation pour les utilisateurs ayant accès à ce fichier.

contentRestrictions[]

object (ContentRestriction)

Restrictions d'accès au contenu du fichier. N'est renseigné que si une telle restriction existe.

kind

string

Uniquement en sortie. Type de fichier. Cette valeur est toujours drive#file.

userPermission

object (Permission)

Uniquement en sortie. Autorisations de l'utilisateur authentifié pour ce fichier.

fileExtension

string

Uniquement en sortie. Composant final de fullFileExtension, avec le texte de fin qui ne semble pas faire partie de l'extension supprimé. Ce champ n'est renseigné que pour les fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs ni pour les fichiers de raccourci.

md5Checksum

string

Uniquement en sortie. Somme de contrôle MD5 pour le contenu de ce fichier. Ce champ n'est renseigné que pour les fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs ni pour les fichiers de raccourci.

lastModifyingUserName

string

Uniquement en sortie. Nom du dernier utilisateur à avoir modifié ce fichier.

editable
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt capabilities/canEdit.

writersCanShare

boolean

Indique si les rédacteurs peuvent partager le document avec d'autres utilisateurs. Non renseigné pour les éléments des Drive partagés.

downloadUrl

string

Uniquement en sortie. URL de téléchargement éphémère du fichier. Ce champ n'est renseigné que pour les fichiers dont le contenu est stocké dans Google Drive. Il n'est pas renseigné pour les fichiers Google Docs ni les fichiers de raccourci.

mimeType

string

Type MIME du fichier. Cette valeur n'est modifiable que lors de la mise en ligne de nouveaux contenus. Vous pouvez laisser ce champ vide. Le type MIME sera déterminé à partir du type MIME du contenu importé.

driveId

string

Uniquement en sortie. ID du Drive partagé dans lequel se trouve le fichier. Renseigné uniquement pour les éléments des Drive partagés.

appDataContents

boolean

Uniquement en sortie. Indique si ce fichier se trouve dans le dossier "Données d'application".

shared

boolean

Uniquement en sortie. Indique si le fichier a été partagé. Non renseigné pour les éléments des Drive partagés.

lastModifyingUser

object (User)

Uniquement en sortie. Dernier utilisateur à avoir modifié ce fichier. Ce champ n'est renseigné que si la dernière modification a été effectuée par un utilisateur connecté.

headRevisionId

string

Uniquement en sortie. ID de la révision principale du fichier. Ce champ n'est renseigné que pour les fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs ni pour les fichiers de raccourci.

copyable
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt capabilities/canCopy.

etag

string

Uniquement en sortie. ETag du fichier.

sharingUser

object (User)

Uniquement en sortie. Utilisateur qui a partagé l'élément avec l'utilisateur actuel, le cas échéant.

fileSize

string (int64 format)

Uniquement en sortie. Taille en octets des blobs et des fichiers de l'éditeur first party. Ne sera pas renseignée pour les fichiers sans taille, comme les raccourcis et les dossiers.

copyRequiresWriterPermission

boolean

Indique si 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.

hasThumbnail

boolean

Uniquement en sortie. Indique si ce fichier possède une miniature. Cela n'indique pas si l'application qui envoie la demande a accès à la miniature. Pour vérifier l'accès, recherchez le champ "thumbnailLink".

folderColorRgb

string

Couleur du dossier sous forme de chaîne hexadécimale RVB si le fichier est un dossier ou un raccourci vers un dossier. La liste des couleurs compatibles est disponible dans le champ "folderColorPalette" de la ressource "About". Si une couleur non compatible est spécifiée, elle sera remplacée par la couleur la plus proche de la palette.

id

string

ID du fichier.

title

string

Titre de ce fichier. Notez que le titre des éléments immuables, tels que les dossiers de premier niveau des Drive partagés, le dossier racine Mon Drive et le dossier "Données d'application", est constant.

description

string

Brève description du fichier.

labels

object

Groupe de libellés pour le fichier.

labels.viewed

boolean

Indique si ce fichier a été consulté par cet utilisateur.

labels.restricted
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt copyRequiresWriterPermission.

labels.starred

boolean

Indique si l'utilisateur a ajouté ce fichier à ses favoris.

labels.hidden
(deprecated)

boolean

Uniquement en sortie. Obsolète.

labels.trashed

boolean

Indique si ce fichier a été placé dans la corbeille. Ce libellé s'applique à tous les utilisateurs qui accèdent au fichier. Toutefois, seuls les propriétaires sont autorisés à voir et à restaurer les fichiers.

labels.modified

boolean

Uniquement en sortie. Indique si le fichier a été modifié par cet utilisateur.

explicitlyTrashed

boolean

Uniquement en sortie. Indique si ce fichier a été explicitement placé dans la corbeille, par opposition à un placement récursif.

createdDate

string

Uniquement en sortie. Heure de création de ce fichier (horodatage au format RFC 3339).

modifiedDate

string

Date et heure de la dernière modification apportée à ce fichier par un utilisateur (code temporel au format RFC 3339). Ce paramètre n'est modifiable lors de la mise à jour que lorsque le paramètre setModifiedDate est défini.

modifiedByMeDate

string

Uniquement en sortie. Dernière modification de ce fichier par l'utilisateur (code temporel au format RFC 3339). Notez que la définition de modifiedDate met également à jour la date modifiedByMe pour l'utilisateur qui a défini la date.

lastViewedByMeDate

string

Dernière fois que l'utilisateur a consulté ce fichier (code temporel au format RFC 3339).

markedViewedByMeDate
(deprecated)

string

Uniquement en sortie. Obsolète.

sharedWithMeDate

string

Uniquement en sortie. Heure à laquelle ce fichier a été partagé avec l'utilisateur (code temporel au format RFC 3339).

quotaBytesUsed

string (int64 format)

Uniquement en sortie. Nombre d'octets de quota utilisés par ce fichier.

version

string (int64 format)

Uniquement en sortie. Numéro de version du fichier, qui augmente de façon monotone. Cela reflète toutes les modifications apportées au fichier sur le serveur, même celles qui ne sont pas visibles par l'utilisateur qui en fait la demande.

indexableText

object

Attributs de texte indexables pour le fichier (ne peuvent être écrits)

indexableText.text

string

Texte à indexer pour ce fichier.

originalFilename

string

Nom de fichier d'origine du contenu importé, s'il est disponible, ou valeur d'origine du champ title. Cette option n'est disponible que pour les fichiers incluant du contenu binaire dans Google Drive.

ownedByMe

boolean

Uniquement en sortie. Indique si le fichier appartient à l'utilisateur actuel. Non renseigné pour les éléments des Drive partagés.

canComment
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt capabilities/canComment.

shareable
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt capabilities/canShare.

fullFileExtension

string

Uniquement en sortie. Extension de fichier complète, extraite du titre. Peut contenir plusieurs extensions concaténées, telles que "tar.gz". La suppression d'une extension du titre n'efface pas ce champ. Toutefois, si vous modifiez l'extension du titre, ce champ est mis à jour. Ce champ n'est renseigné que pour les fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs ni pour les fichiers de raccourci.

isAppAuthorized

boolean

Uniquement en sortie. Indique si le fichier a été créé ou ouvert par l'application à l'origine de la requête.

teamDriveId
(deprecated)

string

Uniquement en sortie. Obsolète : utilisez plutôt driveId.

capabilities

object

Uniquement en sortie. Capacités dont dispose l'utilisateur actuel sur ce fichier. Chaque capacité correspond à une action précise qu'un utilisateur peut effectuer.

capabilities.canChangeRestrictedDownload
(deprecated)

boolean

Uniquement en sortie. Obsolète.

capabilities.canMoveChildrenOutOfDrive

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut déplacer les éléments enfants de ce dossier en dehors du Drive partagé. Cette valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés.

capabilities.canReadDrive

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut lire le Drive partagé auquel appartient ce fichier. Renseigné uniquement pour les éléments des Drive partagés.

capabilities.canEdit

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier ce fichier. D'autres facteurs peuvent limiter le type de modifications qu'un utilisateur peut apporter à un fichier. Par exemple, consultez canChangeCopyRequiresWriterPermission ou canModifyContent.

capabilities.canCopy

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut copier ce fichier. Pour un élément dans un Drive partagé, indique si l'utilisateur actuel peut copier les descendants non-dossiers de cet élément, ou cet élément lui-même s'il ne s'agit pas d'un dossier.

capabilities.canComment

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut commenter ce fichier.

capabilities.canAddChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut ajouter des enfants à ce dossier. Cette valeur est toujours "false" lorsque l'élément n'est pas un dossier.

capabilities.canDelete

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut supprimer ce fichier.

capabilities.canDownload

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut télécharger ce fichier.

capabilities.canListChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut lister les enfants de ce dossier. Cette valeur est toujours "false" lorsque l'élément n'est pas un dossier.

capabilities.canRemoveChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut supprimer des enfants de ce dossier. Cette 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

Uniquement en sortie. Indique si l'utilisateur actuel peut renommer ce fichier.

capabilities.canTrash

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut placer ce fichier dans la corbeille.

capabilities.canReadRevisions

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut lire la ressource "revisions" de ce fichier. Indique si les révisions des descendants non-dossiers de cet élément, ou cet élément lui-même s'il n'est pas un dossier, peuvent être lues pour un élément de Drive partagé.

capabilities.canReadTeamDrive
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez canMoveItemWithinDrive ou canMoveItemOutOfDrive à la place.

capabilities.canChangeCopyRequiresWriterPermission

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier la restriction copyRequiresWriterPermission de ce fichier.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt canMoveItemOutOfDrive.

capabilities.canUntrash

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut restaurer ce fichier depuis la corbeille.

capabilities.canModifyContent

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier le contenu de ce fichier.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut supprimer les enfants de ce dossier. Cette valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut supprimer les éléments enfants de ce dossier. Cette valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés.

capabilities.canMoveItemOutOfDrive

boolean

Uniquement en sortie. 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.canAddMyDriveParent

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut ajouter un parent à l'élément sans supprimer un parent existant dans la même requête. Non renseigné pour les fichiers de Drive partagé.

capabilities.canRemoveMyDriveParent

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut supprimer un parent de l'élément sans en ajouter un autre dans la même requête. Non renseigné pour les fichiers de Drive partagé.

capabilities.canMoveItemWithinDrive

boolean

Uniquement en sortie. 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 de celui supprimé.

capabilities.canShare

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier les paramètres de partage de ce fichier.

capabilities.canMoveChildrenWithinDrive

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut déplacer les enfants de ce dossier dans ce Drive. Cette valeur est "false" lorsque l'élément n'est pas un dossier. Notez qu'une demande de déplacement de l'enfant peut toujours échouer en fonction de l'accès de l'utilisateur actuel à l'enfant et au dossier de destination.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Obsolète : sortie uniquement. Utilisez canModifyEditorContentRestriction, canModifyOwnerContentRestriction ou canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut ajouter un dossier provenant d'un autre Drive (Drive partagé différent ou Mon Drive) à ce dossier. Cette valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés.

capabilities.canChangeSecurityUpdateEnabled

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier le champ "securityUpdateEnabled" dans les métadonnées de partage de lien.

capabilities.canAcceptOwnership

boolean

Uniquement en sortie. Indique si l'utilisateur actuel est le propriétaire en attente du fichier. Non renseigné pour les fichiers de Drive partagé.

capabilities.canReadLabels

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut lire les libellés du fichier.

capabilities.canModifyLabels

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier les libellés du fichier.

capabilities.canModifyEditorContentRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut ajouter ou modifier les restrictions de contenu du fichier qui sont réservées aux éditeurs.

capabilities.canModifyOwnerContentRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut ajouter ou modifier des restrictions de contenu réservées au propriétaire.

capabilities.canRemoveContentRestriction

boolean

Uniquement en sortie. Indique si le fichier est soumis à une restriction de contenu qui peut être supprimée par l'utilisateur actuel.

capabilities.canDisableInheritedPermissions

boolean

Uniquement en sortie. Indique si un utilisateur peut désactiver les autorisations héritées.

capabilities.canEnableInheritedPermissions

boolean

Uniquement en sortie. Indique si un utilisateur peut réactiver les autorisations héritées.

hasAugmentedPermissions

boolean

Uniquement en sortie. Indique si des autorisations sont directement associées à ce fichier. Ce champ n'est renseigné que pour les éléments des Drive partagés.

trashingUser

object (User)

Uniquement en sortie. Si le fichier a été explicitement placé dans la corbeille, l'utilisateur qui l'a fait. Renseigné uniquement pour les éléments des Drive partagés.

canReadRevisions
(deprecated)

boolean

Uniquement en sortie. Obsolète : utilisez plutôt capabilities/canReadRevisions.

thumbnailVersion

string (int64 format)

Uniquement en sortie. Version miniature à utiliser pour l'invalidation du cache de miniatures.

trashedDate

string

Uniquement en sortie. Heure à laquelle l'élément a été mis à la corbeille (code temporel au format RFC 3339). Renseigné uniquement pour les éléments des Drive partagés.

thumbnail

object

Vignette du fichier. Elle ne sera utilisée que si une miniature standard ne peut pas être générée.

thumbnail.image

string (bytes format)

Octets de l'image miniature encodés en base64 sécurisé pour les URL. Elle doit être conforme à la section 5 de la norme RFC 4648.

Chaîne encodée en base64.

thumbnail.mimeType

string

Type MIME de la miniature.

imageMediaMetadata

object

Uniquement en sortie. Métadonnées sur les images. Cette section n'est présente que pour les types d'images. Son contenu dépend de ce qui peut être analysé à partir du contenu de l'image.

imageMediaMetadata.flashUsed

boolean

Uniquement en sortie. Indique si un flash a été utilisé pour créer la photo.

imageMediaMetadata.meteringMode

string

Uniquement en sortie. Mode de mesure utilisé pour créer la photo.

imageMediaMetadata.sensor

string

Uniquement en sortie. Type de capteur utilisé pour créer la photo.

imageMediaMetadata.exposureMode

string

Uniquement en sortie. Mode d'exposition utilisé pour créer la photo.

imageMediaMetadata.colorSpace

string

Uniquement en sortie. Espace colorimétrique de la photo.

imageMediaMetadata.whiteBalance

string

Uniquement en sortie. Mode de balance des blancs utilisé pour créer la photo.

imageMediaMetadata.width

integer

Uniquement en sortie. Largeur de l'image en pixels.

imageMediaMetadata.height

integer

Uniquement en sortie. Hauteur de l'image en pixels.

imageMediaMetadata.location

object

Uniquement en sortie. Informations sur l'emplacement géographique stockées dans l'image.

imageMediaMetadata.location.latitude

number

Uniquement en sortie. Latitude stockée dans l'image.

imageMediaMetadata.location.longitude

number

Uniquement en sortie. Longitude stockée dans l'image.

imageMediaMetadata.location.altitude

number

Uniquement en sortie. Altitude stockée dans l'image.

imageMediaMetadata.rotation

integer

Uniquement en sortie. Nombre de rotations de 90 degrés dans le sens des aiguilles d'une montre appliquées à l'orientation d'origine de l'image.

imageMediaMetadata.date

string

Uniquement en sortie. Date et heure auxquelles la photo a été prise (code temporel au format EXIF).

imageMediaMetadata.cameraMake

string

Uniquement en sortie. Marque de l'appareil photo utilisé pour créer la photo.

imageMediaMetadata.cameraModel

string

Uniquement en sortie. Modèle de l'appareil photo utilisé pour créer la photo.

imageMediaMetadata.exposureTime

number

Uniquement en sortie. Durée de l'exposition, en secondes.

imageMediaMetadata.aperture

number

Uniquement en sortie. Ouverture utilisée pour créer la photo (nombre f).

imageMediaMetadata.focalLength

number

Uniquement en sortie. Distance focale utilisée pour créer la photo, en millimètres.

imageMediaMetadata.isoSpeed

integer

Uniquement en sortie. Sensibilité ISO utilisée pour créer la photo.

imageMediaMetadata.exposureBias

number

Uniquement en sortie. Biais d'exposition de la photo (valeur APEX).

imageMediaMetadata.maxApertureValue

number

Uniquement en sortie. Nombre f le plus petit de l'objectif à la distance focale utilisée pour créer la photo (valeur APEX).

imageMediaMetadata.subjectDistance

integer

Uniquement en sortie. Distance du sujet de la photo, en mètres.

imageMediaMetadata.lens

string

Uniquement en sortie. Objectif utilisé pour prendre la photo.

videoMediaMetadata

object

Uniquement en sortie. Métadonnées sur le contenu vidéo. Cette option n'est disponible que pour les types de vidéos.

videoMediaMetadata.width

integer

Uniquement en sortie. Largeur de la vidéo en pixels.

videoMediaMetadata.height

integer

Uniquement en sortie. Hauteur de la vidéo en pixels.

videoMediaMetadata.durationMillis

string (int64 format)

Uniquement en sortie. Durée de la vidéo en millisecondes.

shortcutDetails

object

Détails du fichier de raccourci. Renseigné uniquement pour les fichiers de raccourci, dont le champ mimeType est défini sur application/vnd.google-apps.shortcut. Ne peut être défini que sur les requêtes files.insert.

shortcutDetails.targetId

string

ID du fichier vers lequel pointe ce raccourci. Ne peut être défini que sur les requêtes files.insert.

shortcutDetails.targetMimeType

string

Uniquement en sortie. 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.

shortcutDetails.targetResourceKey

string

Uniquement en sortie. ResourceKey du fichier cible.

resourceKey

string

Uniquement en sortie. Clé requise pour accéder à l'élément via un lien partagé.

linkShareMetadata.securityUpdateEligible

boolean

Uniquement en sortie. Indique si le fichier est éligible à une mise à jour de sécurité.

linkShareMetadata.securityUpdateEnabled

boolean

Uniquement en sortie. Indique si la mise à jour de sécurité est activée pour ce fichier.

labelInfo

object

Uniquement en sortie. Présentation des libellés du fichier.

labelInfo.labels[]

object (Label)

Uniquement en sortie. Ensemble d'étiquettes dans le fichier, comme demandé par les ID d'étiquettes dans le paramètre includeLabels. Par défaut, aucun libellé n'est renvoyé.

sha1Checksum

string

Uniquement en sortie. Somme de contrôle SHA1 associée à ce fichier, le cas échéant. Ce champ n'est renseigné que pour les 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

Uniquement en sortie. Somme de contrôle SHA256 associée à ce fichier, le cas échéant. Ce champ n'est renseigné que pour les fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs ni pour les fichiers de raccourci.

inheritedPermissionsDisabled

boolean

Indique si les autorisations héritées de ce fichier sont désactivées. Les autorisations héritées sont activées par défaut.

ContentRestriction

Restriction d'accès au contenu du fichier.

Représentation JSON
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionDate": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
Champs
readOnly

boolean

Indique si le contenu du fichier est en lecture seule. Si un fichier est en lecture seule, il est impossible d'y ajouter une révision, d'y ajouter ou modifier des commentaires, ou d'en modifier le titre.

reason

string

La raison pour laquelle le contenu du fichier est soumis à des restrictions. Ce champ n'est modifiable que dans les requêtes qui définissent également readOnly=true.

type

string

Uniquement en sortie. Type de restriction de contenu. Actuellement, la seule valeur possible est globalContentRestriction.

restrictingUser

object (User)

Uniquement en sortie. Utilisateur qui a défini la restriction de contenu. N'est renseigné que si la valeur de readOnly est "true".

restrictionDate

string

Uniquement en sortie. Heure à laquelle la restriction de contenu a été définie (code temporel au format RFC 3339). N'est renseigné que si la valeur de readOnly est "true".

ownerRestricted

boolean

Indique si la restriction de contenu ne peut être modifiée ou supprimée que par un utilisateur propriétaire du fichier. Pour les fichiers dans les Drive partagés, tout utilisateur disposant des droits organizer peut modifier ou supprimer cette restriction de contenu.

systemRestricted

boolean

Uniquement en sortie. Indique si la restriction de contenu a été appliquée par le système, par exemple en raison d'une signature électronique. Les utilisateurs ne peuvent pas modifier ni supprimer les restrictions de contenu système.

Méthodes

copy

Crée une copie du fichier spécifié.

delete

Supprime définitivement un fichier appartenant à l'utilisateur sans le placer dans la corbeille.

emptyTrash

Supprime définitivement tous les fichiers placés dans la corbeille de l'utilisateur.

export

Exporte un document Google Workspace au type MIME demandé et renvoie le contenu des octets exportés.

generateIds

Génère un ensemble d'ID de fichiers pouvant être fournis dans les requêtes d'insertion ou de copie.

get

Récupère les métadonnées ou le contenu d'un fichier par ID.

insert

Insère un nouveau fichier.

list

Liste les fichiers de l'utilisateur.

listLabels

Liste les libellés d'un fichier.

modifyLabels

Modifie l'ensemble des libellés appliqués à un fichier.

patch

Met à jour les métadonnées et/ou le contenu d'un fichier.

touch

Définissez l'heure de mise à jour du fichier sur l'heure actuelle du serveur.

trash

Place un fichier dans la corbeille.

untrash

Restaure un fichier de la corbeille.

update

Met à jour les métadonnées et/ou le contenu d'un fichier.

watch

S'abonne aux modifications apportées à un fichier.