Files

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

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Métadonnées d'un fichier.

{
  "kind": "drive#file",
  "id": string,
  "name": string,
  "mimeType": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "trashingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "trashedTime": datetime,
  "parents": [
    string
  ],
  "properties": {
    (key): string
  },
  "appProperties": {
    (key): string
  },
  "spaces": [
    string
  ],
  "version": long,
  "webContentLink": string,
  "webViewLink": string,
  "iconLink": string,
  "hasThumbnail": boolean,
  "thumbnailLink": string,
  "thumbnailVersion": long,
  "viewedByMe": boolean,
  "viewedByMeTime": datetime,
  "createdTime": datetime,
  "modifiedTime": datetime,
  "modifiedByMeTime": datetime,
  "modifiedByMe": boolean,
  "sharedWithMeTime": datetime,
  "sharingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "owners": [
    {
      "kind": "drive#user",
      "displayName": string,
      "photoLink": string,
      "me": boolean,
      "permissionId": string,
      "emailAddress": string
    }
  ],
  "teamDriveId": string,
  "driveId": string,
  "lastModifyingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "shared": boolean,
  "ownedByMe": boolean,
  "capabilities": {
    "canAcceptOwnership": boolean,
    "canAddChildren": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canChangeViewersCanCopyContent": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDelete": boolean,
    "canDeleteChildren": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canModifyContent": boolean,
    "canModifyContentRestriction": boolean,
    "canModifyLabels": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemWithinDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canReadLabels": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canReadDrive": boolean,
    "canRemoveChildren": boolean,
    "canRemoveMyDriveParent": boolean,
    "canRename": boolean,
    "canShare": boolean,
    "canTrash": boolean,
    "canTrashChildren": boolean,
    "canUntrash": boolean
  },
  "viewersCanCopyContent": boolean,
  "copyRequiresWriterPermission": boolean,
  "writersCanShare": boolean,
  "permissions": [
    permissions Resource
  ],
  "permissionIds": [
    string
  ],
  "hasAugmentedPermissions": boolean,
  "folderColorRgb": string,
  "originalFilename": string,
  "fullFileExtension": string,
  "fileExtension": string,
  "md5Checksum": string,
  "sha1Checksum": string,
  "sha256Checksum": string,
  "size": long,
  "quotaBytesUsed": long,
  "headRevisionId": string,
  "contentHints": {
    "thumbnail": {
      "image": bytes,
      "mimeType": string
    },
    "indexableText": string
  },
  "imageMediaMetadata": {
    "width": integer,
    "height": integer,
    "rotation": integer,
    "location": {
      "latitude": double,
      "longitude": double,
      "altitude": double
    },
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": float,
    "aperture": float,
    "flashUsed": boolean,
    "focalLength": float,
    "isoSpeed": integer,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "exposureBias": float,
    "maxApertureValue": float,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": long
  },
  "isAppAuthorized": boolean,
  "exportLinks": {
    (key): string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      "readOnly": boolean,
      "reason": string,
      "restrictingUser": {
        "kind": "drive#user",
        "displayName": string,
        "photoLink": string,
        "me": boolean,
        "permissionId": string,
        "emailAddress": string
      },
      "restrictionTime": datetime,
      "type": string
    }
  ],
  "labelInfo": {
    "labels": [
      {
        "kind": "drive#label",
        "id": string,
        "revisionId": string,
        "fields": {
          (key): {
            "kind": "drive#labelField",
            "id": string,
            "valueType": string,
            "dateString": [
              date
            ],
            "integer": [
              long
            ],
            "selection": [
              string
            ],
            "text": [
              string
            ],
            "user": [
              {
                "kind": "drive#user",
                "displayName": string,
                "photoLink": string,
                "me": boolean,
                "permissionId": string,
                "emailAddress": string
              }
            ]
          }
        }
      }
    ]
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  }
}
Nom de propriété Valeur Description Remarques
kind string Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#file".
id string ID du fichier. accessible en écriture
name string Nom du fichier. Cela n'est pas nécessairement unique dans un dossier. Notez que pour les éléments immuables tels que les dossiers racines des Drive partagés, le dossier racine Mon Drive et le dossier "Données d'application", le nom est constant. accessible en écriture
mimeType string Type MIME du fichier.

Si aucune valeur n'est fournie, Google Drive tente de détecter automatiquement la valeur appropriée du contenu importé. La valeur ne peut être modifiée que si une nouvelle révision est importée.

Si un fichier est créé avec un type MIME Google Docs, le contenu importé est importé, si possible. Les formats d'importation compatibles sont publiés dans la ressource "À propos".

accessible en écriture
description string Brève description du fichier. accessible en écriture
starred boolean Indique si l'utilisateur a activé le suivi du fichier. accessible en écriture
trashed boolean Indique si le fichier a été placé dans la corbeille, que ce soit explicitement ou à partir d'un dossier parent placé dans la corbeille. Seul le propriétaire peut placer un fichier dans la corbeille. L'élément placé dans la corbeille est exclu de toutes les réponses files.list renvoyées pour les utilisateurs qui ne sont pas propriétaires du fichier. Toutefois, tous les utilisateurs ayant accès au fichier peuvent voir les métadonnées des éléments placés dans la corbeille dans une réponse de l'API. Tous les utilisateurs disposant d'un accès peuvent copier, télécharger, exporter et partager le fichier. accessible en écriture
explicitlyTrashed boolean Indique si le fichier a été explicitement placé dans la corbeille, et non de manière récursive dans un dossier parent.
parents[] list ID des dossiers parents contenant le fichier.

S'il n'est pas spécifié comme faisant partie d'une demande de création, le fichier sera placé directement dans le dossier Mon Drive de l'utilisateur. S'il n'est pas spécifié dans une demande de copie, le fichier hérite des parents visibles du fichier source. Les requêtes de mise à jour doivent utiliser les paramètres addParents et removeParents pour modifier la liste des parents.

accessible en écriture
properties object Ensemble de paires clé-valeur arbitraires visibles par toutes les applications.

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

accessible en écriture
properties.(key) string
appProperties object Ensemble de paires clé/valeur arbitraires qui sont privées de l'application à l'origine de la demande.

Les entrées avec des valeurs NULL sont effacées dans les requêtes de mise à jour et de copie. Ces propriétés ne peuvent être récupérées qu'à l'aide d'une requête authentifiée. Une requête authentifiée utilise un jeton d'accès obtenu avec un ID client OAuth 2. Vous ne pouvez pas utiliser de clé API pour récupérer des propriétés privées.

accessible en écriture
appProperties.(key) string
spaces[] list Liste des espaces contenant le fichier. Les valeurs actuellement acceptées sont "drive", "appDataFolder" et "photos".
version long Numéro de version qui augmente de façon monotone pour le fichier. Cela reflète chaque modification apportée au fichier sur le serveur, même celles qui ne sont pas visibles par l'utilisateur.
viewedByMe boolean Indique si le fichier a été consulté par cet utilisateur.
viewedByMeTime datetime Heure de la dernière consultation du fichier par l'utilisateur (date et heure RFC 3339). accessible en écriture
createdTime datetime Date et heure auxquelles le fichier a été créé (date et heure RFC 3339). accessible en écriture
modifiedTime datetime Heure de la dernière modification du fichier par n'importe quel utilisateur (date et heure RFC 3339).

Notez que la modification de l'élément "timeTime" a également pour effet de mettre à jour l'élément "modificationByMeTime" de l'utilisateur.

accessible en écriture
modifiedByMeTime datetime Heure de la dernière modification du fichier par l'utilisateur (date et heure RFC 3339).
sharedWithMeTime datetime Heure à laquelle le fichier a été partagé avec l'utilisateur, le cas échéant (heure RFC 3339).
sharingUser nested object Utilisateur ayant partagé le fichier avec l'utilisateur à l'origine de la demande, le cas échéant.
sharingUser.kind string Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user".
sharingUser.displayName string Nom à afficher en texte brut pour cet utilisateur.
sharingUser.me boolean Indique si cet utilisateur est l'utilisateur à l'origine de la demande.
sharingUser.permissionId string ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation.
sharingUser.emailAddress string Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur.
owners[] list Propriétaire de ce fichier. Seuls certains anciens fichiers peuvent avoir plusieurs propriétaires. Ce champ n'est pas renseigné pour les éléments des Drive partagés.
owners[].kind string Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user".
owners[].displayName string Nom à afficher en texte brut pour cet utilisateur.
owners[].me boolean Indique si cet utilisateur est l'utilisateur à l'origine de la demande.
owners[].permissionId string ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation.
owners[].emailAddress string Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur.
lastModifyingUser nested object Dernier utilisateur à modifier le fichier.
lastModifyingUser.kind string Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user".
lastModifyingUser.displayName string Nom à afficher en texte brut pour cet utilisateur.
lastModifyingUser.me boolean Indique si cet utilisateur est l'utilisateur à l'origine de la demande.
lastModifyingUser.permissionId string ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation.
lastModifyingUser.emailAddress string Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur.
shared boolean Indique si le fichier a été partagé. Non renseigné pour les éléments des Drive partagés.
ownedByMe boolean Indique si l'utilisateur est propriétaire du fichier. Non renseigné pour les éléments des Drive partagés.
viewersCanCopyContent boolean Obsolète. Utilisez plutôt copyRequiresWriterPermission.
writersCanShare boolean Indique si les utilisateurs disposant uniquement de l'autorisation writer peuvent modifier les autorisations du fichier. Non renseigné pour les éléments des Drive partagés. accessible en écriture
permissions[] list Liste complète des autorisations pour le fichier. Cette option n'est disponible que si l'utilisateur à l'origine de la demande peut partager le fichier. Non renseigné pour les éléments des Drive partagés.
folderColorRgb string Couleur d'un dossier ou d'un raccourci vers un dossier sous forme de chaîne hexadécimale RVB. Les couleurs compatibles sont publiées dans le champ folderColorPalette de la ressource "À propos".

Si une couleur non acceptée est spécifiée, la couleur la plus proche dans la palette sera utilisée à la place.

accessible en écriture
originalFilename string Nom de fichier d'origine du contenu importé (si disponible) ou valeur d'origine du champ name. Cette option n'est disponible que pour les fichiers à contenu binaire dans Google Drive. accessible en écriture
fullFileExtension string Extension de fichier complète extraite du champ name. Peut contenir plusieurs extensions concaténées, telles que "tar.gz". Cette option n'est disponible que pour les fichiers à contenu binaire dans Google Drive.

Ce champ est automatiquement mis à jour en cas de modification du champ name, mais il n'est pas effacé si le nouveau nom ne contient pas d'extension valide.

fileExtension string Dernier composant de fullFileExtension. Cette option n'est disponible que pour les fichiers à contenu binaire dans Google Drive.
md5Checksum string Somme de contrôle MD5 du contenu du fichier. Cela ne concerne que les fichiers au contenu binaire dans Google Drive.
size long Taille du contenu du fichier en octets. Ce champ est renseigné pour les fichiers au contenu binaire stockés dans Google Drive et pour les fichiers des éditeurs Docs. Il ne l'est pas pour les raccourcis ni pour les dossiers.
quotaBytesUsed long Nombre d'octets de quota de stockage utilisés par le fichier. Cela inclut la révision principale et les révisions précédentes pour lesquelles keepForever est activé.
headRevisionId string ID de la révision principale du fichier. Actuellement, cette fonctionnalité n'est disponible que pour les fichiers à contenu binaire dans Google Drive.
contentHints object Informations supplémentaires sur le contenu du fichier. Ces champs ne sont jamais renseignés dans les réponses.
contentHints.thumbnail object Vignette du fichier. Elle ne sera utilisée que si Google Drive ne peut pas générer de vignette standard.
contentHints.thumbnail.image bytes Données de vignette encodées en base64 sans risque pour les URL (section 5 de la norme RFC 4648). accessible en écriture
contentHints.thumbnail.mimeType string Type MIME de la vignette. accessible en écriture
contentHints.indexableText string Texte à indexer pour le fichier afin d'améliorer les requêtes fullText. La taille est limitée à 128 Ko et peut contenir des éléments HTML. Pour en savoir plus, consultez Gérer les métadonnées de fichiers. accessible en écriture
imageMediaMetadata object Métadonnées supplémentaires sur les médias image, si disponibles.
imageMediaMetadata.width integer Largeur de l'image en pixels.
imageMediaMetadata.height integer Hauteur de l'image en pixels.
imageMediaMetadata.rotation integer Nombre de rotations de 90° vers la droite appliquées à partir de l'orientation de l'image d'origine.
imageMediaMetadata.location object Informations de géolocalisation stockées dans l'image.
imageMediaMetadata.location.latitude double Latitude stockée dans l'image.
imageMediaMetadata.location.longitude double Longitude stockée dans l'image.
imageMediaMetadata.location.altitude double Altitude stockée dans l'image.
imageMediaMetadata.time string Date et heure de la photo (EXIF DateTime).
imageMediaMetadata.cameraMake string Marque de l'appareil photo utilisé pour créer la photo.
imageMediaMetadata.cameraModel string Modèle de l'appareil photo utilisé pour créer la photo.
imageMediaMetadata.exposureTime float Durée de l'exposition, en secondes.
imageMediaMetadata.aperture float Ouverture utilisée pour créer la photo (f-number).
imageMediaMetadata.flashUsed boolean Indique si un flash a été utilisé pour créer la photo.
imageMediaMetadata.focalLength float Longueur focale utilisée pour créer la photo, en millimètres.
imageMediaMetadata.isoSpeed integer Vitesse ISO utilisée pour créer la photo.
imageMediaMetadata.meteringMode string Mode de mesure utilisé pour créer la photo.
imageMediaMetadata.sensor string Type de capteur utilisé pour créer la photo.
imageMediaMetadata.exposureMode string Mode d'exposition utilisé pour créer la photo.
imageMediaMetadata.colorSpace string Espace colorimétrique de la photo.
imageMediaMetadata.whiteBalance string Mode de balance des blancs utilisé pour créer la photo.
imageMediaMetadata.exposureBias float Biais d'exposition de la photo (valeur EXEX).
imageMediaMetadata.maxApertureValue float Plus petit nombre f de l'objectif à la distance focale utilisée pour créer la photo (valeur EXEX).
imageMediaMetadata.subjectDistance integer Distance par rapport au sujet de la photo, en mètres.
imageMediaMetadata.lens string Objectif utilisé pour créer la photo.
videoMediaMetadata object Métadonnées supplémentaires sur les médias vidéo. Cette fonctionnalité peut ne pas être disponible immédiatement après l'importation.
videoMediaMetadata.width integer Largeur de la vidéo, en pixels.
videoMediaMetadata.height integer Hauteur de la vidéo, en pixels.
videoMediaMetadata.durationMillis long Durée de la vidéo en millisecondes.
capabilities object Fonctionnalités dont dispose l'utilisateur actuel sur ce fichier. Chaque capacité correspond à une action précise qu'un utilisateur peut effectuer.
capabilities.canEdit boolean Indique si l'utilisateur actuel peut modifier ce fichier. D'autres facteurs peuvent limiter le type de modifications qu'un utilisateur peut apporter au fichier. Par exemple, consultez canChangeCopyRequiresWriterPermission ou canModifyContent.
capabilities.canComment boolean Indique si l'utilisateur actuel peut ajouter des commentaires à ce fichier.
capabilities.canShare boolean Indique si l'utilisateur actuel peut modifier les paramètres de partage de ce fichier.
capabilities.canCopy boolean Indique si l'utilisateur actuel peut copier ce fichier. Pour un élément dans un Drive partagé, que l'utilisateur actuel puisse copier les descendants hors dossier de cet élément, ou cet élément lui-même s'il ne s'agit pas d'un dossier.
capabilities.canReadRevisions boolean Indique si l'utilisateur actuel peut lire la ressource des révisions de ce fichier. Pour un élément de Drive partagé, il est possible de lire les révisions des descendants hors de cet élément, ou cet élément s'il ne s'agit pas d'un dossier.
isAppAuthorized boolean Indique si le fichier a été créé ou ouvert par l'application à l'origine de la demande.
hasThumbnail boolean Indique si ce fichier comporte une vignette. Cela n'indique pas si l'application à l'origine de la demande a accès à la vignette. Pour vérifier l'accès, recherchez la présence du champ "thumbnailLink".
thumbnailVersion long Version de vignette à utiliser en cas d'invalidation de cache de vignettes.
modifiedByMe boolean Indique si l'utilisateur a modifié le fichier.
trashingUser nested object Si le fichier a été explicitement placé dans la corbeille, l'utilisateur qui l'a placé dans la corbeille. Renseigné uniquement pour les éléments des Drive partagés.
trashingUser.kind string Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user".
trashingUser.displayName string Nom à afficher en texte brut pour cet utilisateur.
trashingUser.me boolean Indique si cet utilisateur est l'utilisateur à l'origine de la demande.
trashingUser.permissionId string ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation.
trashingUser.emailAddress string Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur.
trashedTime datetime Date et heure auxquelles l'élément a été placé dans la corbeille (date et heure RFC 3339). Renseigné uniquement pour les éléments des Drive partagés.
teamDriveId string Obsolète. Utilisez plutôt driveId.
capabilities.canAddChildren boolean Indique si l'utilisateur actuel peut ajouter des enfants à ce dossier. La valeur est toujours "false" lorsque l'élément n'est pas un dossier.
capabilities.canDelete boolean Indique si l'utilisateur actuel peut supprimer ce fichier.
capabilities.canDownload boolean Indique si l'utilisateur actuel peut télécharger ce fichier.
capabilities.canListChildren boolean Indique si l'utilisateur actuel peut répertorier les enfants de ce dossier. La valeur est toujours "false" lorsque l'élément n'est pas un dossier.
capabilities.canMoveTeamDriveItem boolean Obsolète. Utilisez plutôt canMoveItemWithinDrive ou canMoveItemOutOfDrive.
capabilities.canMoveItemIntoTeamDrive boolean Obsolète. Utilisez plutôt canMoveItemOutOfDrive.
capabilities.canReadTeamDrive boolean Obsolète. Utilisez plutôt canReadDrive.
capabilities.canRemoveChildren boolean Indique si l'utilisateur actuel peut supprimer des enfants de ce dossier. La valeur est toujours "false" lorsque l'élément n'est pas un dossier. Pour un dossier dans un Drive partagé, utilisez plutôt canDeleteChildren ou canTrashChildren.
capabilities.canRename boolean Indique si l'utilisateur actuel peut renommer ce fichier.
capabilities.canTrash boolean Indique si l'utilisateur actuel peut placer ce fichier dans la corbeille.
capabilities.canUntrash boolean Indique si l'utilisateur actuel peut restaurer ce fichier à partir de la corbeille.
hasAugmentedPermissions boolean Indique s'il existe des autorisations directement sur ce fichier. Ce champ n'est renseigné que pour les éléments des Drive partagés.
capabilities.canChangeViewersCanCopyContent boolean Obsolète
permissionIds[] list Liste des ID d'autorisation des utilisateurs ayant accès à ce fichier.
capabilities.canChangeCopyRequiresWriterPermission boolean Indique si l'utilisateur actuel peut modifier la restriction copyRequiresWriterPermission de ce fichier.
copyRequiresWriterPermission boolean Les options permettant de copier, d'imprimer ou de télécharger ce fichier doivent être désactivées pour les lecteurs et les commentateurs. accessible en écriture
capabilities.canDeleteChildren boolean Indique si l'utilisateur actuel peut supprimer les enfants de ce dossier. La valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés.
capabilities.canMoveChildrenOutOfTeamDrive boolean Obsolète. Utilisez plutôt canMoveChildrenOutOfDrive.
capabilities.canMoveChildrenWithinTeamDrive boolean Obsolète. Utilisez plutôt canMoveChildrenWithinDrive.
capabilities.canMoveItemOutOfTeamDrive boolean Obsolète. Utilisez plutôt canMoveItemOutOfDrive.
capabilities.canMoveItemWithinTeamDrive boolean Obsolète. Utilisez plutôt canMoveItemWithinDrive.
capabilities.canTrashChildren boolean Indique si l'utilisateur actuel peut placer les enfants de ce dossier dans la corbeille. La valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés.
exportLinks.(key) string Mappage entre le format d'exportation et l'URL
driveId string ID du Drive partagé dans lequel se trouve le fichier. Renseigné uniquement pour les éléments des Drive partagés.
capabilities.canMoveChildrenOutOfDrive boolean Indique si l'utilisateur actuel peut déplacer les enfants de ce dossier en dehors du Drive partagé. La valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés.
capabilities.canMoveChildrenWithinDrive boolean Indique si l'utilisateur actuel peut déplacer les enfants de ce dossier dans ce Drive. La valeur est "false" lorsque l'élément n'est pas un dossier. Notez qu'une requête de déplacement de l'enfant peut néanmoins échouer en fonction de l'accès de l'utilisateur actuel à l'enfant et au dossier de destination.
capabilities.canMoveItemOutOfDrive boolean Indique si l'utilisateur actuel peut déplacer cet élément en dehors de ce Drive en modifiant son parent. Notez qu'une demande de modification du parent de l'élément peut toujours échouer en fonction du nouveau parent ajouté.
capabilities.canMoveItemWithinDrive boolean Indique si l'utilisateur actuel peut déplacer cet élément dans ce Drive. Notez qu'une demande de modification du parent de l'élément peut toujours échouer en fonction du nouveau parent ajouté et du parent en cours de suppression.
capabilities.canReadDrive boolean Indique si l'utilisateur actuel peut lire le Drive partagé auquel ce fichier appartient. Renseigné uniquement pour les éléments des Drive partagés.
capabilities.canModifyContent boolean Indique si l'utilisateur actuel peut modifier le contenu de ce fichier.
capabilities.canAddMyDriveParent boolean Indique si l'utilisateur actuel peut ajouter un parent à l'élément sans supprimer de parent dans la même requête. Non renseigné pour les fichiers des Drive partagés.
capabilities.canRemoveMyDriveParent boolean Indique si l'utilisateur actuel peut supprimer un parent de l'élément sans ajouter d'autre parent dans la même demande. Non renseigné pour les fichiers des Drive partagés.
shortcutDetails object Détails du fichier de raccourci. Valeur renseignée uniquement pour les fichiers de raccourci, pour lesquels le champ "mimeType" est défini sur application/vnd.google-apps.shortcut.
shortcutDetails.targetId string ID du fichier vers lequel pointe ce raccourci. accessible en écriture
shortcutDetails.targetMimeType string Type MIME du fichier vers lequel pointe ce raccourci. La valeur de ce champ est un instantané du type MIME de la cible, capturé lors de la création du raccourci.
capabilities.canAddFolderFromAnotherDrive boolean Indique si l'utilisateur actuel peut ajouter à ce dossier un dossier stocké dans un autre Drive partagé (autre que le Drive partagé ou Mon Drive). La valeur est "false" lorsque l'élément n'est pas un dossier. Renseigné uniquement pour les éléments des Drive partagés.
capabilities.canModifyContentRestriction boolean Indique si l'utilisateur actuel peut modifier les restrictions sur le contenu de ce fichier.
contentRestrictions[] list Restrictions d'accès au contenu du fichier. Renseigné uniquement si une telle restriction existe.
contentRestrictions[].readOnly boolean Indique si le contenu du fichier est en lecture seule. Si un fichier est en lecture seule, il est impossible d'ajouter une nouvelle révision du fichier, d'ajouter des commentaires ou de modifier le titre du fichier. accessible en écriture
contentRestrictions[].reason string Raison pour laquelle le contenu du fichier est restreint. Cela n'est modifiable que pour les requêtes qui définissent également readOnly=true. accessible en écriture
contentRestrictions[].restrictingUser nested object Utilisateur ayant défini la restriction de contenu. N'est renseigné que si la valeur de readOnly est "true".
contentRestrictions[].restrictingUser.kind string Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user".
contentRestrictions[].restrictingUser.displayName string Nom à afficher en texte brut pour cet utilisateur.
contentRestrictions[].restrictingUser.me boolean Indique si cet utilisateur est l'utilisateur à l'origine de la demande.
contentRestrictions[].restrictingUser.permissionId string ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation.
contentRestrictions[].restrictingUser.emailAddress string Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur.
contentRestrictions[].restrictionTime datetime Date et heure auxquelles la restriction de contenu a été définie (horodatage au format RFC 3339 mis en forme). N'est renseigné que si la valeur de readOnly est "true".
contentRestrictions[].type string Type de restriction de contenu. Actuellement, la seule valeur possible est globalContentRestriction.
capabilities.canChangeSecurityUpdateEnabled boolean Indique si l'utilisateur actuel peut modifier le champ securityUpdateEnabled sur les métadonnées de partage par lien.
shortcutDetails.targetResourceKey string Clé de ressource pour le fichier cible.
resourceKey string Une clé est nécessaire pour accéder à l'élément via un lien partagé.
linkShareMetadata object Contient des informations sur les URL des liens que les clients utilisent pour faire référence à cet élément.
linkShareMetadata.securityUpdateEligible boolean Indique si le fichier peut être mis à jour pour la sécurité.
linkShareMetadata.securityUpdateEnabled boolean Indique si la mise à jour de sécurité est activée pour ce fichier.
capabilities.canAcceptOwnership boolean Indique si l'utilisateur actuel est le propriétaire en attente du fichier. Non renseigné pour les fichiers des Drive partagés.
capabilities.canModifyLabels boolean Indique si l'utilisateur actuel peut modifier les libellés de ce fichier.
capabilities.canReadLabels boolean Indique si l'utilisateur actuel peut lire les libellés de ce fichier.
labelInfo object Présentation des libellés du fichier.
labelInfo.labels[] list Ensemble d'étiquettes du fichier, tel que demandé par les ID d'étiquette dans le paramètre includeLabels. Par défaut, aucun libellé n'est renvoyé.
labelInfo.labels[].kind string Il s'agit toujours de drive#label
labelInfo.labels[].id string ID du libellé.
labelInfo.labels[].revisionId string ID de révision du libellé.
labelInfo.labels[].fields object Carte des champs du libellé associés à l'ID du champ.
labelInfo.labels[].fields.(key) nested object
labelInfo.labels[].fields.(key).kind string Il s'agit toujours de drive#labelField.
labelInfo.labels[].fields.(key).id string Identifiant de ce champ.
labelInfo.labels[].fields.(key).valueType string Type de champ. Les nouvelles valeurs pourront être acceptées ultérieurement, mais les suivantes sont actuellement autorisées :
  • Chaîne de date
  • integer
  • des caractéristiques
  • text
  • utilisateur
labelInfo.labels[].fields.(key).dateString[] list Uniquement présente si valueType est dateString. Date au format RFC 3339: AAAA-MM-JJ.
labelInfo.labels[].fields.(key).integer[] list Uniquement présente si valueType est integer.
labelInfo.labels[].fields.(key).selection[] list Uniquement présente si valueType est selection.
labelInfo.labels[].fields.(key).text[] list Uniquement présente si valueType est text.
labelInfo.labels[].fields.(key).user[] list Uniquement présente si valueType est user.
labelInfo.labels[].fields.(key).user[].kind string Identifie le type de ressource dont il s'agit. Valeur: chaîne fixe "drive#user".
labelInfo.labels[].fields.(key).user[].displayName string Nom à afficher en texte brut pour cet utilisateur.
labelInfo.labels[].fields.(key).user[].me boolean Indique si cet utilisateur est l'utilisateur à l'origine de la demande.
labelInfo.labels[].fields.(key).user[].permissionId string ID de l'utilisateur tel qu'il apparaît dans les ressources d'autorisation.
labelInfo.labels[].fields.(key).user[].emailAddress string Adresse e-mail de l'utilisateur. Elle peut ne pas être présente dans certains contextes si l'utilisateur n'a pas rendu son adresse e-mail visible au demandeur.
sha1Checksum string Somme de contrôle SHA1 associée à ce fichier, si disponible. Ce champ n'est renseigné que pour des fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs, ni pour les fichiers de raccourci.
sha256Checksum string Somme de contrôle SHA256 associée à ce fichier, si disponible. Ce champ n'est renseigné que pour des fichiers dont le contenu est stocké dans Google Drive. Il ne l'est pas pour les éditeurs Docs, ni pour les fichiers de raccourci.

Méthodes

copie
Crée une copie d'un fichier et applique toutes les mises à jour demandées avec la sémantique "patch". Impossible de copier les dossiers.
créer
Crée un fichier.
supprimer
Supprime définitivement un fichier appartenant à l'utilisateur sans le placer dans la corbeille. Si le fichier appartient à un Drive partagé, l'utilisateur doit être l'organisateur du parent. Si la cible est un dossier, tous les descendants appartenant à l'utilisateur sont également supprimés.
Vider la corbeille
Supprime définitivement tous les fichiers placés dans la corbeille de l'utilisateur.
exporter
Exporte un document Google Workspace vers le type MIME demandé et renvoie le contenu d'octets exporté. Notez que le contenu exporté est limité à 10 Mo.
generateIds
Génère un ensemble d'ID de fichier qui peuvent être fournis dans des requêtes de création ou de copie.
obtenir
Récupère les métadonnées ou le contenu d'un fichier par ID.
list
Répertorie ou recherche des fichiers.
mettre à jour
Met à jour les métadonnées et/ou le contenu d'un fichier. Lorsque vous appelez cette méthode, ne renseignez que les champs de la requête que vous souhaitez modifier. Lors de la mise à jour de champs, certains champs peuvent changer automatiquement, tels que changedDate. Cette méthode est compatible avec la sémantique "patch".
montre
S'abonne aux modifications apportées à un fichier. Vous pouvez définir un canal de distribution pour les modifications apportées à un fichier d'un Drive partagé, mais la modification d'un fichier n'entraîne pas de notification.
listLabels.
Répertorie les libellés d'un fichier.
modifyLabels
Modifie l'ensemble des libellés d'un fichier.