Cette page a été traduite par l'API Cloud Translation.

REST Resource: files

Ressource : File
Méthodes

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

Représentation JSON
{ "exportLinks": { string: string, ... }, "parents": [ string ], "owners": [ { object (`User`) } ], "permissions": [ { object (`Permission`) } ], "spaces": [ string ], "properties": { string: value, ... }, "appProperties": { string: value, ... }, "permissionIds": [ string ], "contentRestrictions": [ { object (`ContentRestriction`) } ], "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "headRevisionId": string, "sharingUser": { object (`User`) }, "webViewLink": string, "webContentLink": string, "size": string, "viewersCanCopyContent": boolean, "hasThumbnail": boolean, "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, "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, "canDisableInheritedPermissions": boolean, "canEnableInheritedPermissions": boolean, "canChangeItemDownloadRestriction": boolean }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "thumbnailVersion": string, "trashedTime": string, "modifiedByMe": boolean, "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 }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean, "downloadRestrictions": { object (`DownloadRestrictionsMetadata`) } }

{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "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,
  "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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}

Champs
`exportLinks`	`map (key: string, value: string)` Uniquement en sortie. Liens permettant d'exporter des fichiers des éditeurs Docs dans des formats spécifiques. Objet contenant une liste de paires `"key": value`. Exemple : `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` 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. S'il n'est pas spécifié dans une requête 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 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.
`permissions[]`	`object (Permission)` Uniquement en sortie. Liste complète des autorisations pour le fichier. Cette option n'est disponible que si l'utilisateur qui envoie la demande peut partager le fichier. Non renseigné pour les éléments des Drive partagés.
`spaces[]`	`string` Uniquement en sortie. Liste des espaces contenant le fichier. Les valeurs actuellement acceptées sont "drive", "appDataFolder" et "photos".
`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 demandes 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))` Collection de paires clé-valeur arbitraires qui sont privées pour l'application demandant l'opération. Les entrées avec des valeurs nulles sont effacées dans les demandes 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" }`.
`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. Identifie le type de ressource. 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. Le dernier composant de `fullFileExtension`. Cette option n'est disponible que pour les fichiers incluant du contenu binaire dans Google Drive.
`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.
`md5Checksum`	`string` Uniquement en sortie. Somme de contrôle MD5 du contenu du fichier. Cette option n'est disponible que pour les fichiers incluant 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. Cette description est limitée à 128 Ko et peut contenir des éléments HTML.
`contentHints.thumbnail`	`object` Vignette du fichier. Cette option ne sera utilisée que si Google Drive ne peut pas générer de miniature standard.
`contentHints.thumbnail.image`	`string (bytes format)` Données de la miniature encodées en base64 sécurisé pour les URL (section 5 de la norme RFC 4648). Chaîne encodée en base64.
`contentHints.thumbnail.mimeType`	`string` Type MIME de la miniature.
`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.
`viewedByMe`	`boolean` Uniquement en sortie. Indique si le fichier a été consulté par cet utilisateur.
`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 pas être modifiée, sauf 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 acceptés sont publiés dans la ressource "À propos".
`thumbnailLink`	`string` Uniquement en sortie. Lien temporaire vers la miniature du fichier, si disponible. Elle dure généralement plusieurs heures. N'est pas destiné à être utilisé directement sur les applications Web en raison des règles de partage des ressources entre origines multiples (CORS). Envisagez d'utiliser un serveur proxy. Renseigné uniquement lorsque l'application à l'origine de la requête peut accéder au contenu du fichier. Si le fichier n'est pas partagé publiquement, l'URL renvoyée dans `Files.thumbnailLink` doit être récupérée à l'aide d'une requête authentifiée.
`iconLink`	`string` Uniquement en sortie. Lien statique non authentifié vers l'icône du fichier.
`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. Le dernier utilisateur à avoir modifié le 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. Cette option n'est actuellement disponible que pour les fichiers incluant du contenu binaire dans Google Drive.
`sharingUser`	`object (User)` Uniquement en sortie. L'utilisateur qui a partagé le fichier avec l'utilisateur demandeur, le cas échéant.
`webViewLink`	`string` Uniquement en sortie. Lien permettant d'ouvrir le fichier dans un éditeur ou une visionneuse Google appropriés dans un navigateur.
`webContentLink`	`string` Uniquement en sortie. Lien permettant de télécharger le contenu du fichier dans un navigateur. Cette option n'est disponible que pour les fichiers incluant du contenu binaire dans Google Drive.
`size`	`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.
`viewersCanCopyContent (deprecated)`	`boolean` Cet élément est obsolète. Obsolète : utilisez plutôt `copyRequiresWriterPermission`.
`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 d'un dossier ou d'un raccourci vers un dossier sous forme de chaîne hexadécimale RVB. Les couleurs acceptées sont publiées dans le champ `folderColorPalette` de la ressource "About". Si une couleur non compatible est spécifiée, la couleur la plus proche de la palette est utilisée à la place.
`id`	`string` ID du fichier.
`name`	`string` Nom du fichier. Il n'est pas nécessairement unique dans un dossier. Notez que le nom 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.
`starred`	`boolean` Indique si l'utilisateur a ajouté le fichier à ses favoris.
`trashed`	`boolean` Indique si le fichier a été placé dans la corbeille, de manière explicite ou à partir d'un dossier parent placé dans la corbeille. Seul le propriétaire peut placer un fichier dans la corbeille. Les autres utilisateurs ne peuvent pas voir les fichiers qui s'y trouvent.
`explicitlyTrashed`	`boolean` Uniquement en sortie. Indique si le fichier a été explicitement placé dans la corbeille, par opposition à un placement récursif dans la corbeille à partir d'un dossier parent.
`createdTime`	`string` Heure de création du fichier (date et heure RFC 3339).
`modifiedTime`	`string` Date et heure de la dernière modification du fichier par un utilisateur (RFC 3339). Notez que le paramètre `modifiedTime` met également à jour `modifiedByMeTime` pour l'utilisateur.
`modifiedByMeTime`	`string` Uniquement en sortie. Date et heure de la dernière modification du fichier par l'utilisateur (RFC 3339).
`viewedByMeTime`	`string` Dernière fois que l'utilisateur a consulté le fichier (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 au format RFC 3339).
`quotaBytesUsed`	`string (int64 format)` Uniquement en sortie. Quota de stockage (en octets) utilisé par le fichier. Cela inclut la révision principale, ainsi que les révisions précédentes pour lesquelles `keepForever` est activé.
`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.
`originalFilename`	`string` Nom de fichier d'origine du contenu importé, s'il est disponible, ou valeur d'origine du champ `name`. Cette option n'est disponible que pour les fichiers incluant du 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, telles que "tar.gz". Cette option n'est disponible que pour les fichiers incluant du contenu binaire dans Google Drive. Cette valeur est automatiquement mise à jour lorsque le champ `name` change. Toutefois, elle n'est pas effacée si le nouveau nom ne contient pas d'extension valide.
`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` Cet élément est obsolète. Obsolète : sortie uniquement. Utilisez `driveId` à la place.
`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.canChangeViewersCanCopyContent (deprecated)`	`boolean` Obsolète : sortie uniquement.
`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` 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` de 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. 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` 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 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` Indique si un utilisateur peut désactiver les autorisations héritées.
`capabilities.canEnableInheritedPermissions`	`boolean` Indique si un utilisateur peut réactiver les autorisations héritées.
`capabilities.canChangeItemDownloadRestriction`	`boolean` Uniquement en sortie. Indique si l'utilisateur actuel peut modifier les restrictions de téléchargement appliquées par le propriétaire ou l'organisateur du fichier.
`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.
`thumbnailVersion`	`string (int64 format)` Uniquement en sortie. Version miniature à utiliser pour l'invalidation du cache de miniatures.
`trashedTime`	`string` Uniquement en sortie. Heure à laquelle l'élément a été placé dans la corbeille (date et heure RFC 3339). 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.
`imageMediaMetadata`	`object` Uniquement en sortie. Métadonnées supplémentaires sur le contenu multimédia de l'image, si 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 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.time`	`string` Uniquement en sortie. La date et l'heure auxquelles la photo a été prise (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 (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 supplémentaires sur le contenu vidéo. Il est possible qu'elle ne soit pas disponible 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. 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.create`.
`shortcutDetails.targetId`	`string` ID du fichier vers lequel pointe ce raccourci. Ne peut être défini que sur les requêtes `files.create`.
`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`	`object` Uniquement en sortie. Détails concernant LinkShare. Contient des informations sur les URL de liens que les clients utilisent pour faire référence à cet élément.
`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.
`downloadRestrictions`	`object (DownloadRestrictionsMetadata)` Des restrictions de téléchargement sont appliquées au fichier.

ContentRestriction

Restriction d'accès au contenu du fichier.

Représentation JSON
{ "readOnly": boolean, "reason": string, "type": string, "restrictingUser": { object (`User`) }, "restrictionTime": 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".
`restrictionTime`	`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.

DownloadRestrictionsMetadata

Des restrictions de téléchargement sont appliquées au fichier.

Représentation JSON
{ "itemDownloadRestriction": { object (`DownloadRestriction`) }, "effectiveDownloadRestrictionWithContext": { object (`DownloadRestriction`) } }

Champs

itemDownloadRestriction

object (DownloadRestriction)

La restriction de téléchargement du fichier appliquée directement par le propriétaire ou l'organisateur. Cela ne tient pas compte des paramètres des Drive partagés ni des règles de protection contre la perte de données.

effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

Uniquement en sortie. Restriction de téléchargement effective appliquée à ce fichier. Cela tient compte de tous les paramètres de restriction et des règles de protection contre la perte de données.

DownloadRestriction

Restriction de la copie et du téléchargement du fichier.

Représentation JSON
{ "restrictedForReaders": boolean, "restrictedForWriters": boolean }

Champs

Champs
`restrictedForReaders`	`boolean` Indique si le téléchargement et la copie sont restreints pour les lecteurs.
`restrictedForWriters`	`boolean` Indique si le téléchargement et la copie sont restreints pour les éditeurs. Si la valeur est "true", le téléchargement est également limité pour les lecteurs.

restrictedForReaders

boolean

Indique si le téléchargement et la copie sont restreints pour les lecteurs.

restrictedForWriters

boolean

Indique si le téléchargement et la copie sont restreints pour les éditeurs. Si la valeur est "true", le téléchargement est également limité pour les lecteurs.

Méthodes
`copy`	Crée une copie d'un fichier et applique les modifications demandées avec la sémantique de correctif.
`create`	Crée un fichier.
`delete`	Supprime définitivement un fichier appartenant à l'utilisateur sans le placer dans la corbeille.
`download`	Télécharge le contenu d'un fichier.
`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 qui peuvent ê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'abonne aux modifications apportées à un fichier.

REST Resource: files

Ressource : File

ContentRestriction

DownloadRestrictionsMetadata

DownloadRestriction

Méthodes

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`

REST Resource: files Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ressource : File

ContentRestriction

DownloadRestrictionsMetadata

DownloadRestriction

Méthodes

REST Resource: files