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
{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": 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
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    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,
    "time": 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
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}
Champs
kind

string

Uniquement en sortie. Identifie le type de ressource de cette valeur. Valeur: chaîne fixe "drive#file".

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.

fileExtension

string

Uniquement en sortie. Dernier composant de fullFileExtension. Cette option n'est disponible que pour les fichiers au contenu binaire dans Google Drive.

copyRequiresWriterPermission

boolean

Indique si les options de copie, d'impression ou de téléchargement de ce fichier doivent être désactivées pour les lecteurs et les commentateurs.

md5Checksum

string

Uniquement en sortie. Somme de contrôle MD5 du contenu du fichier. Cela ne s'applique qu'aux fichiers comportant du 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.indexableText

string

Texte à indexer pour le fichier afin d'améliorer les requêtes fullText. Elle est limitée à 128 ko et peut contenir des éléments HTML.

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

string (bytes format)

Données de vignette encodées en base64 adaptée aux URL (section 5 de la norme RFC 4648)

Chaîne encodée en base64.

contentHints.thumbnail.mimeType

string

Type MIME de la vignette.

writersCanShare

boolean

Permet de spécifier 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.

viewedByMe

boolean

Uniquement en sortie. Indique si cet utilisateur a consulté le fichier.

mimeType

string

Type MIME du fichier.

Si aucune valeur n'est fournie, Google Drive tente de détecter automatiquement une valeur appropriée à partir 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".

parents[]

string

ID des dossiers parents contenant le fichier.

S'il n'est pas spécifié lors d'une demande de création, 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 tous les parents visibles du fichier source. Les requêtes files.update doivent utiliser les paramètres addParents et removeParents pour modifier la liste des parents.

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é le fichier.

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 Drive partagés.

headRevisionId

string

Uniquement en sortie. ID de la révision principale du fichier. Actuellement, cette fonctionnalité n'est disponible que pour les fichiers au contenu binaire dans Google Drive.

sharingUser

object (User)

Uniquement en sortie. Utilisateur ayant partagé le fichier avec l'utilisateur à l'origine de la demande, le cas échéant.

size

string (int64 format)

Uniquement en sortie. Taille en octets des blobs et des fichiers d'éditeur propriétaires. ne sera pas renseigné pour les fichiers sans taille, tels que les raccourcis et les dossiers ;

viewersCanCopyContent
(deprecated)

boolean

Obsolète: utilisez plutôt copyRequiresWriterPermission.

permissions[]

object (Permission)

Uniquement en sortie. Liste complète des autorisations du 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.

hasThumbnail

boolean

Uniquement en sortie. Permet de spécifier si le fichier a 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".

spaces[]

string

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

folderColorRgb

string

Couleur d'un dossier ou 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 est utilisée.

id

string

Identifiant du fichier.

name

string

Nom du fichier. Elle 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 de l'application", le nom est constant.

description

string

Brève description du fichier.

starred

boolean

Indique si l'utilisateur a activé le suivi du fichier.

trashed

boolean

Si le fichier a été placé dans la corbeille, que ce soit explicitement ou depuis un dossier parent dans la corbeille Seul le propriétaire peut placer un fichier dans la corbeille, et les autres utilisateurs ne peuvent pas voir les fichiers placés dans la corbeille.

explicitlyTrashed

boolean

Uniquement en sortie. Si le fichier a été explicitement placé dans la corbeille, et non de manière récursive dans un dossier parent

createdTime

string

Heure de création du fichier (date et heure RFC 3339).

modifiedTime

string

Dernière modification du fichier par n'importe quel utilisateur (date et heure RFC 3339).

Notez que le paramètre modifiedTime met également à jour modifiedByMeTime pour l'utilisateur.

modifiedByMeTime

string

Uniquement en sortie. Dernière modification du fichier par l'utilisateur (date et heure RFC 3339).

viewedByMeTime

string

Heure de la dernière consultation du fichier par l'utilisateur (date et heure RFC 3339).

sharedWithMeTime

string

Uniquement en sortie. Heure à laquelle le fichier a été partagé avec l'utilisateur, le cas échéant (date et heure RFC 3339).

quotaBytesUsed

string (int64 format)

Uniquement en sortie. Nombre d'octets de quota de stockage utilisés par le fichier. Cela inclut la révision principale ainsi que toutes les révisions précédentes pour lesquelles keepForever est activé.

version

string (int64 format)

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

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 au contenu binaire dans Google Drive.

ownedByMe

boolean

Uniquement en sortie. Indique si l'utilisateur est propriétaire du fichier. Non renseigné pour les éléments des Drive partagés.

fullFileExtension

string

Uniquement en sortie. Extension de fichier complète extraite du champ name. Peut contenir plusieurs extensions concaténées, par exemple "tar.gz". Cette option n'est disponible que pour les fichiers au contenu binaire dans Google Drive.

Cela est automatiquement mis à jour lorsque le champ name change. Cependant, la valeur n'est pas effacée si le nouveau nom ne contient pas d'extension valide.

properties

map (key: string, value: value (Value format))

Ensemble de paires clé-valeur arbitraires visibles par toutes les applications.

Les entrées avec des valeurs nulles sont effacées dans les requêtes de mise à jour et de copie.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

appProperties

map (key: string, value: value (Value format))

Ensemble de paires clé-valeur arbitraires qui sont privées pour l'application à l'origine de la demande.

Les entrées avec des valeurs nulles 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.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

Obsolète: sortie uniquement. Utilisez driveId à la place.

capabilities

object

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

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

Obsolète: sortie uniquement.

capabilities.canMoveChildrenOutOfDrive

boolean

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

boolean

Uniquement en sortie. 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.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, voir canChangeCopyRequiresWriterPermission ou canModifyContent.

capabilities.canCopy

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut copier ce fichier. Pour un élément d'un Drive partagé, indiquez si l'utilisateur actuel peut copier les descendants non-dossiers de cet élément, ou de cet élément 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. La 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. La 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. La valeur est toujours "false" lorsque l'élément n'est pas un dossier. Utilisez plutôt canDeleteChildren ou canTrashChildren pour un dossier dans un Drive partagé.

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 de révision de ce fichier. Vous pouvez lire les modifications apportées aux descendants autres que des dossiers de cet élément, ou bien de cet élément s'il ne s'agit pas d'un dossier pour un élément de Drive partagé.

capabilities.canReadTeamDrive
(deprecated)

boolean

Obsolète: sortie uniquement. Utilisez canReadDrive à la place.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Obsolète: sortie uniquement. Utilisez canMoveItemWithinDrive ou canMoveItemOutOfDrive à la place.

capabilities.canChangeCopyRequiresWriterPermission

boolean

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

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Obsolète: sortie uniquement. Utilisez canMoveItemOutOfDrive à la place.

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

Obsolète: sortie uniquement. Utilisez canMoveItemWithinDrive à la place.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Obsolète: sortie uniquement. Utilisez canMoveItemOutOfDrive à la place.

capabilities.canDeleteChildren

boolean

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

boolean

Obsolète: sortie uniquement. Utilisez canMoveChildrenOutOfDrive à la place.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Obsolète: sortie uniquement. Utilisez canMoveChildrenWithinDrive à la place.

capabilities.canTrashChildren

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut placer les enfants dans 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.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 qui est ajouté.

capabilities.canAddMyDriveParent

boolean

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

capabilities.canRemoveMyDriveParent

boolean

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

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 qui est ajouté et du parent en cours de suppression.

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. La valeur est "false" lorsque l'élément n'est pas un dossier. Notez qu'une demande de déplacement de l'enfant peut tout de même échouer en fonction de l'accès que l'utilisateur actuel a à 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 à ce dossier un dossier provenant d'un autre Drive (autre 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.canChangeSecurityUpdateEnabled

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut modifier le champ securityUpdateEnabled sur les métadonnées du partage par 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és.

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 des restrictions de contenu limitées au fichier pour l'éditeur.

capabilities.canModifyOwnerContentRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut ajouter ou modifier des restrictions de contenu qui sont limitées par le propriétaire.

capabilities.canRemoveContentRestriction

boolean

Uniquement en sortie. Indique si l'utilisateur actuel peut restreindre le contenu d'un fichier.

hasAugmentedPermissions

boolean

Uniquement en sortie. Indique si des autorisations sont disponibles directement sur 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 placé dans la corbeille. Renseigné uniquement pour les éléments des Drive partagés.

thumbnailVersion

string (int64 format)

Uniquement en sortie. Version de vignette à utiliser dans l'invalidation du cache de miniatures.

trashedTime

string

Uniquement en sortie. Heure à laquelle l'élément a été placé dans la corbeille (RFC 3339, date-heure). Renseigné uniquement pour les éléments des Drive partagés.

modifiedByMe

boolean

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

permissionIds[]

string

Résultat uniquement. files.list d'ID d'autorisation pour les utilisateurs ayant accès à ce fichier.

imageMediaMetadata

object

Uniquement en sortie. Métadonnées supplémentaires sur les images des médias, si elles sont disponibles.

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 de couleur 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 enregistré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 vers la droite appliquées à l'orientation d'origine de l'image.

imageMediaMetadata.time

string

Uniquement en sortie. Date et heure de la prise de vue (EXIF DateTime).

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 (f-number).

imageMediaMetadata.focalLength

number

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

imageMediaMetadata.isoSpeed

integer

Uniquement en sortie. Vitesse 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 par rapport au sujet de la photo, en mètres.

imageMediaMetadata.lens

string

Uniquement en sortie. Objectif utilisé pour créer la photo.

videoMediaMetadata

object

Uniquement en sortie. Métadonnées supplémentaires concernant les médias vidéo. Il est possible qu'elles ne soient pas disponibles immédiatement après l'importation.

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. Valeur renseignée seulement pour les fichiers de raccourci dans lesquels le champ "mimeType" est défini sur application/vnd.google-apps.shortcut.

shortcutDetails.targetId

string

ID du fichier vers lequel ce raccourci pointe.

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. Ressource ResourceKey du fichier cible.

contentRestrictions[]

object (ContentRestriction)

Restrictions concernant l'accès au contenu du fichier. Valeur renseignée seulement si une telle restriction existe.

resourceKey

string

Uniquement en sortie. Une clé permettant d'accéder à l'élément via un lien partagé

linkShareMetadata.securityUpdateEligible

boolean

Uniquement en sortie. Indique si le fichier est éligible à la 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 de libellés du fichier, comme demandé par les ID de libellé 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, si disponible. 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 raccourcis.

sha256Checksum

string

Uniquement en sortie. Somme de contrôle SHA256 associée à ce fichier, si disponible. 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 raccourcis.

Restriction de contenu

Restriction d'accès au contenu du fichier.

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

boolean

Indique si le contenu du fichier est en lecture seule. Si un fichier est en lecture seule, il n'est pas possible d'ajouter de nouvelles révisions du fichier, de laisser des commentaires ni de modifier le titre du fichier.

reason

string

Raison pour laquelle le contenu du fichier est limité. Cela n'est modifiable que sur 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".

restrictionTime

string

Uniquement en sortie. Heure à laquelle la restriction de contenu a été définie (horodatage 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 des Drive partagés, tout utilisateur disposant des droits d'accès organizer peut modifier ou supprimer cette restriction de contenu.

Méthodes

copy

Crée une copie d'un fichier et applique toutes les mises à jour demandées avec la sémantique patch.

create

Crée un fichier.

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 vers le type MIME demandé et renvoie le contenu d'octets exporté.

generateIds

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

get

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

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.

update

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

watch

S'abonner aux modifications apportées à un fichier