Ce service permet aux scripts de créer, de rechercher et de modifier des fichiers et des dossiers dans Google Drive.
Si votre script utilise un projet Cloud standard au lieu d'un projet Cloud par défaut, vous devez activer manuellement l'API Drive. Dans votre projet Cloud standard, activez l'API Drive:
L'exemple de code suivant montre comment consigner le nom de chaque fichier dans le dossier "Mon Drive" de l'utilisateur :// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
console.log(file.getName());
}
Classes
Nom | Brève description |
---|---|
Access | Enumération représentant les classes d'utilisateurs autorisés à accéder à un fichier ou à un dossier, en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
DriveApp | Permet aux scripts de créer, de rechercher et de modifier des fichiers et des dossiers dans Google Drive. |
File | Fichier dans Google Drive |
FileIterator | Itérateur qui permet aux scripts d'itérer sur une collection potentiellement importante de fichiers. |
Folder | Dossier dans Google Drive |
FolderIterator | Objet permettant aux scripts d'itérer sur une collection potentiellement importante de dossiers. |
Permission | Enumération représentant les autorisations accordées aux utilisateurs pouvant accéder à un fichier ou à un dossier, en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
User | Utilisateur associé à un fichier dans Google Drive. |
Access
Propriétés
Propriété | Type | Description |
---|---|---|
ANYONE | Enum | Recherche et accès autorisés pour tous les internautes |
ANYONE_WITH_LINK | Enum | Tout utilisateur disposant du lien peut y accéder. |
DOMAIN | Enum | Les membres de votre domaine peuvent le trouver et y accéder. |
DOMAIN_WITH_LINK | Enum | Les utilisateurs de votre domaine disposant du lien peuvent y accéder. |
PRIVATE | Enum | Accès réservé aux utilisateurs disposant d'une autorisation expresse. |
DriveApp
Propriétés
Propriété | Type | Description |
---|---|---|
Access | Access | Enumération représentant les classes d'utilisateurs autorisés à accéder à un fichier ou à un dossier, en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
Permission | Permission | Enumération représentant les autorisations accordées aux utilisateurs pouvant accéder à un fichier ou à un dossier, en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | Réengage une itération de fichier à l'aide d'un jeton de continuation d'un itérateur précédent. |
continueFolderIterator(continuationToken) | FolderIterator | Réengage une itération de dossier à l'aide d'un jeton de continuation d'un itérateur précédent. |
createFile(blob) | File | Crée un fichier dans la racine de Drive de l'utilisateur à partir d'un Blob donné de données arbitraires. |
createFile(name, content) | File | Crée un fichier texte à la racine de Drive de l'utilisateur avec le nom et le contenu donnés. |
createFile(name, content, mimeType) | File | Crée un fichier à la racine de Drive de l'utilisateur avec le nom, le contenu et le type MIME donnés. |
createFolder(name) | Folder | Crée un dossier dans le répertoire racine de Drive de l'utilisateur avec le nom donné. |
createShortcut(targetId) | File | Crée un raccourci vers l'ID d'élément Drive fourni, puis le renvoie. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Crée un raccourci vers l'ID de l'élément Drive et la clé de ressource fournis, puis le renvoie. |
enforceSingleParent(value) | void | Active ou désactive le comportement enforceSingleParent pour tous les appels affectant les parents des éléments. |
getFileById(id) | File | Récupère le fichier avec l'ID donné. |
getFileByIdAndResourceKey(id, resourceKey) | File | Récupère le fichier avec l'ID et la clé de ressource donnés. |
getFiles() | FileIterator | Récupère une collection de tous les fichiers de l'utilisateur dans Drive. |
getFilesByName(name) | FileIterator | Récupère la collection de tous les fichiers du Drive de l'utilisateur portant le nom donné. |
getFilesByType(mimeType) | FileIterator | Récupère la collection de tous les fichiers du Drive de l'utilisateur ayant le type MIME donné. |
getFolderById(id) | Folder | Récupère le dossier avec l'ID donné. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Récupère le dossier avec l'ID et la clé de ressource donnés. |
getFolders() | FolderIterator | Récupère une collection de tous les dossiers de Drive de l'utilisateur. |
getFoldersByName(name) | FolderIterator | Récupère la collection de tous les dossiers du Drive de l'utilisateur portant le nom donné. |
getRootFolder() | Folder | Récupère le dossier racine de Drive de l'utilisateur. |
getStorageLimit() | Integer | Récupère le nombre d'octets que l'utilisateur est autorisé à stocker dans Drive. |
getStorageUsed() | Integer | Récupère le nombre d'octets que l'utilisateur stocke actuellement dans Drive. |
getTrashedFiles() | FileIterator | Récupère une collection de tous les fichiers de la corbeille de Drive de l'utilisateur. |
getTrashedFolders() | FolderIterator | Récupère une collection de tous les dossiers de la corbeille de Drive de l'utilisateur. |
searchFiles(params) | FileIterator | Récupère la collection de tous les fichiers de Drive de l'utilisateur correspondant aux critères de recherche donnés. |
searchFolders(params) | FolderIterator | Récupère une collection de tous les dossiers de Drive de l'utilisateur qui correspondent aux critères de recherche donnés. |
File
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
addCommenter(emailAddress) | File | Ajoutez l'utilisateur donné à la liste des commentateurs de la File . |
addCommenter(user) | File | Ajoutez l'utilisateur donné à la liste des commentateurs de la File . |
addCommenters(emailAddresses) | File | Ajoutez le tableau d'utilisateurs donné à la liste des commentateurs de l'File . |
addEditor(emailAddress) | File | Ajoute l'utilisateur donné à la liste des éditeurs de l'File . |
addEditor(user) | File | Ajoute l'utilisateur donné à la liste des éditeurs de l'File . |
addEditors(emailAddresses) | File | Ajoute le tableau d'utilisateurs donné à la liste des éditeurs de l'File . |
addViewer(emailAddress) | File | Ajoute l'utilisateur donné à la liste des spectateurs de l'File . |
addViewer(user) | File | Ajoute l'utilisateur donné à la liste des spectateurs de l'File . |
addViewers(emailAddresses) | File | Ajoute le tableau d'utilisateurs donné à la liste des spectateurs de l'File . |
getAccess(email) | Permission | Récupère l'autorisation accordée à un utilisateur spécifique. |
getAccess(user) | Permission | Récupère l'autorisation accordée à un utilisateur spécifique. |
getAs(contentType) | Blob | Renvoie les données de cet objet sous forme de blob converti au type de contenu spécifié. |
getBlob() | Blob | Renvoyez les données de cet objet sous forme de blob. |
getDateCreated() | Date | Récupère la date de création de l'File . |
getDescription() | String | Récupère la description de l'File . |
getDownloadUrl() | String | Récupère l'URL permettant de télécharger le fichier. |
getEditors() | User[] | Récupère la liste des éditeurs de cet objet File . |
getId() | String | Récupère l'ID du File . |
getLastUpdated() | Date | Récupère la date de la dernière mise à jour de l'File . |
getMimeType() | String | Récupère le type MIME du fichier. |
getName() | String | Récupère le nom de l'File . |
getOwner() | User | Récupère le propriétaire du fichier. |
getParents() | FolderIterator | Récupère une collection de dossiers qui sont des parents immédiats de l'File . |
getResourceKey() | String | Récupère la clé de ressource de l'File requise pour accéder aux éléments partagés à l'aide d'un lien. |
getSecurityUpdateEligible() | Boolean | Indique si cet élément File peut appliquer la mise à jour de sécurité qui nécessite une clé d'accès aux ressources lorsqu'il est partagé à l'aide d'un lien. |
getSecurityUpdateEnabled() | Boolean | Indique si cet élément File nécessite une clé de ressource pour l'accès lorsqu'il est partagé à l'aide d'un lien. |
getSharingAccess() | Access | Permet d'obtenir la classe d'utilisateurs pouvant accéder à File , en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
getSharingPermission() | Permission | Récupère l'autorisation accordée aux utilisateurs pouvant accéder à File , en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
getSize() | Integer | Récupère le nombre d'octets utilisés pour stocker le File dans Drive. |
getTargetId() | String | S'il s'agit d'un raccourci, renvoie l'ID de l'élément auquel il fait référence. |
getTargetMimeType() | String | S'il s'agit d'un raccourci, renvoie le type MIME de l'élément auquel il fait référence. |
getTargetResourceKey() | String | Si le fichier est un raccourci, renvoie la clé de ressource de l'élément auquel il fait référence. |
getThumbnail() | Blob | Récupère une image miniature du fichier ou null si aucune miniature n'existe. |
getUrl() | String | Récupère l'URL permettant d'ouvrir le File dans une application Google telle que Drive ou Docs. |
getViewers() | User[] | Récupère la liste des lecteurs et des commentateurs de cet File . |
isShareableByEditors() | Boolean | Détermine si les utilisateurs disposant d'autorisations de modification pour le File sont autorisés à partager avec d'autres utilisateurs ou à modifier les autorisations. |
isStarred() | Boolean | Détermine si l'File a été ajouté aux favoris dans Drive de l'utilisateur. |
isTrashed() | Boolean | Détermine si l'File se trouve dans la corbeille de Drive de l'utilisateur. |
makeCopy() | File | Crée une copie du fichier. |
makeCopy(destination) | File | Crée une copie du fichier dans le répertoire de destination. |
makeCopy(name) | File | Crée une copie du fichier et lui attribue le nom fourni. |
makeCopy(name, destination) | File | Crée une copie du fichier dans le répertoire de destination et lui attribue le nom fourni. |
moveTo(destination) | File | Déplace cet élément vers le dossier de destination fourni. |
removeCommenter(emailAddress) | File | Supprime l'utilisateur donné de la liste des commentateurs de l'File . |
removeCommenter(user) | File | Supprime l'utilisateur donné de la liste des commentateurs de l'File . |
removeEditor(emailAddress) | File | Supprime l'utilisateur donné de la liste des éditeurs de l'File . |
removeEditor(user) | File | Supprime l'utilisateur donné de la liste des éditeurs de l'File . |
removeViewer(emailAddress) | File | Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'File . |
removeViewer(user) | File | Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'File . |
revokePermissions(emailAddress) | File | Révoque l'accès à l'File accordé à l'utilisateur donné. |
revokePermissions(user) | File | Révoque l'accès à l'File accordé à l'utilisateur donné. |
setContent(content) | File | Écrase le contenu du fichier par un remplacement donné. |
setDescription(description) | File | Définit la description de File . |
setName(name) | File | Définit le nom de l'File . |
setOwner(emailAddress) | File | Modifie le propriétaire de l'File . |
setOwner(user) | File | Modifie le propriétaire de l'File . |
setSecurityUpdateEnabled(enabled) | File | Indique si File nécessite une clé de ressource pour l'accès lorsqu'il est partagé à l'aide d'un lien. |
setShareableByEditors(shareable) | File | Indique si les utilisateurs disposant des autorisations de modification de l'File sont autorisés à partager avec d'autres utilisateurs ou à modifier les autorisations. |
setSharing(accessType, permissionType) | File | Définit la classe d'utilisateurs pouvant accéder à File et les autorisations accordées à ces utilisateurs, en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
setStarred(starred) | File | Indique si l'File est ajouté aux favoris dans Drive de l'utilisateur. |
setTrashed(trashed) | File | Indique si l'File se trouve dans la corbeille de Drive de l'utilisateur. |
FileIterator
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
getContinuationToken() | String | Récupère un jeton pouvant être utilisé pour reprendre cette itération ultérieurement. |
hasNext() | Boolean | Détermine si l'appel de next() renvoie un élément. |
next() | File | Récupère l'élément suivant de la collection de fichiers ou de dossiers. |
Folder
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
addEditor(emailAddress) | Folder | Ajoute l'utilisateur donné à la liste des éditeurs de l'Folder . |
addEditor(user) | Folder | Ajoute l'utilisateur donné à la liste des éditeurs de l'Folder . |
addEditors(emailAddresses) | Folder | Ajoute le tableau d'utilisateurs donné à la liste des éditeurs de l'Folder . |
addViewer(emailAddress) | Folder | Ajoute l'utilisateur donné à la liste des spectateurs de l'Folder . |
addViewer(user) | Folder | Ajoute l'utilisateur donné à la liste des spectateurs de l'Folder . |
addViewers(emailAddresses) | Folder | Ajoute le tableau d'utilisateurs donné à la liste des spectateurs de l'Folder . |
createFile(blob) | File | Crée un fichier dans le dossier actuel à partir d'un Blob donné de données arbitraires. |
createFile(name, content) | File | Crée un fichier texte dans le répertoire actuel avec le nom et le contenu donnés. |
createFile(name, content, mimeType) | File | Crée un fichier dans le dossier actuel avec le nom, le contenu et le type MIME donnés. |
createFolder(name) | Folder | Crée un dossier dans le dossier actuel avec le nom donné. |
createShortcut(targetId) | File | Crée un raccourci vers l'ID d'élément Drive fourni, puis le renvoie. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Crée un raccourci vers l'ID de l'élément Drive et la clé de ressource fournis, puis le renvoie. |
getAccess(email) | Permission | Récupère l'autorisation accordée à un utilisateur spécifique. |
getAccess(user) | Permission | Récupère l'autorisation accordée à un utilisateur spécifique. |
getDateCreated() | Date | Récupère la date de création de l'Folder . |
getDescription() | String | Récupère la description de l'Folder . |
getEditors() | User[] | Récupère la liste des éditeurs de cet objet Folder . |
getFiles() | FileIterator | Récupère une collection de tous les fichiers qui sont enfants du dossier actuel. |
getFilesByName(name) | FileIterator | Récupère une collection de tous les fichiers qui sont enfants du dossier actuel et portent le nom donné. |
getFilesByType(mimeType) | FileIterator | Récupère une collection de tous les fichiers enfants du dossier actuel et ayant le type MIME donné. |
getFolders() | FolderIterator | Récupère une collection de tous les dossiers enfants du dossier actuel. |
getFoldersByName(name) | FolderIterator | Récupère une collection de tous les dossiers qui sont enfants du dossier actuel et portent le nom donné. |
getId() | String | Récupère l'ID du Folder . |
getLastUpdated() | Date | Récupère la date de la dernière mise à jour de l'Folder . |
getName() | String | Récupère le nom de l'Folder . |
getOwner() | User | Récupère le propriétaire de cet élément Folder . |
getParents() | FolderIterator | Récupère une collection de dossiers qui sont des parents immédiats de l'Folder . |
getResourceKey() | String | Récupère la clé de ressource de l'Folder requise pour accéder aux éléments partagés à l'aide d'un lien. |
getSecurityUpdateEligible() | Boolean | Indique si cet élément Folder peut appliquer la mise à jour de sécurité qui nécessite une clé d'accès aux ressources lorsqu'il est partagé à l'aide d'un lien. |
getSecurityUpdateEnabled() | Boolean | Indique si cet élément Folder nécessite une clé de ressource pour l'accès lorsqu'il est partagé à l'aide d'un lien. |
getSharingAccess() | Access | Récupère la classe d'utilisateurs pouvant accéder à Folder , en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
getSharingPermission() | Permission | Récupère l'autorisation accordée aux utilisateurs pouvant accéder à Folder , en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
getSize() | Integer | Récupère le nombre d'octets utilisés pour stocker le Folder dans Drive. |
getUrl() | String | Récupère l'URL permettant d'ouvrir le Folder dans une application Google telle que Drive ou Docs. |
getViewers() | User[] | Récupère la liste des lecteurs et des commentateurs de cet Folder . |
isShareableByEditors() | Boolean | Détermine si les utilisateurs disposant d'autorisations de modification pour le Folder sont autorisés à partager avec d'autres utilisateurs ou à modifier les autorisations. |
isStarred() | Boolean | Détermine si l'Folder a été ajouté aux favoris dans Drive de l'utilisateur. |
isTrashed() | Boolean | Détermine si l'Folder se trouve dans la corbeille de Drive de l'utilisateur. |
moveTo(destination) | Folder | Déplace cet élément vers le dossier de destination fourni. |
removeEditor(emailAddress) | Folder | Supprime l'utilisateur donné de la liste des éditeurs de l'Folder . |
removeEditor(user) | Folder | Supprime l'utilisateur donné de la liste des éditeurs de l'Folder . |
removeViewer(emailAddress) | Folder | Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Folder . |
removeViewer(user) | Folder | Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Folder . |
revokePermissions(emailAddress) | Folder | Révoque l'accès à l'Folder accordé à l'utilisateur donné. |
revokePermissions(user) | Folder | Révoque l'accès à l'Folder accordé à l'utilisateur donné. |
searchFiles(params) | FileIterator | Récupère une collection de tous les fichiers qui sont enfants du dossier actuel et correspondent aux critères de recherche donnés. |
searchFolders(params) | FolderIterator | Récupère une collection de tous les dossiers qui sont enfants du dossier actuel et correspondent aux critères de recherche donnés. |
setDescription(description) | Folder | Définit la description de Folder . |
setName(name) | Folder | Définit le nom de l'Folder . |
setOwner(emailAddress) | Folder | Modifie le propriétaire de l'Folder . |
setOwner(user) | Folder | Modifie le propriétaire de l'Folder . |
setSecurityUpdateEnabled(enabled) | Folder | Indique si Folder nécessite une clé de ressource pour l'accès lorsqu'il est partagé à l'aide d'un lien. |
setShareableByEditors(shareable) | Folder | Indique si les utilisateurs disposant des autorisations de modification de l'Folder sont autorisés à partager avec d'autres utilisateurs ou à modifier les autorisations. |
setSharing(accessType, permissionType) | Folder | Définit la classe d'utilisateurs pouvant accéder à Folder et les autorisations accordées à ces utilisateurs, en plus des utilisateurs individuels auxquels un accès a été explicitement accordé. |
setStarred(starred) | Folder | Indique si l'Folder est ajouté aux favoris dans Drive de l'utilisateur. |
setTrashed(trashed) | Folder | Indique si l'Folder se trouve dans la corbeille de Drive de l'utilisateur. |
FolderIterator
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
getContinuationToken() | String | Récupère un jeton pouvant être utilisé pour reprendre cette itération ultérieurement. |
hasNext() | Boolean | Détermine si l'appel de next() renvoie un élément. |
next() | Folder | Récupère l'élément suivant de la collection de fichiers ou de dossiers. |
Permission
Propriétés
Propriété | Type | Description |
---|---|---|
VIEW | Enum | Les utilisateurs autorisés à accéder au fichier ou au dossier ne peuvent le consulter ou le copier que. |
EDIT | Enum | Les utilisateurs qui peuvent accéder au fichier ou au dossier peuvent le modifier. |
COMMENT | Enum | Les utilisateurs autorisés à accéder au fichier ou au dossier ne peuvent le consulter, le copier ou le commenter que. |
OWNER | Enum | L'utilisateur est le propriétaire du fichier ou du dossier. |
ORGANIZER | Enum | Utilisateurs autorisés à organiser des fichiers et des dossiers dans un Drive partagé |
FILE_ORGANIZER | Enum | Utilisateurs autorisés à modifier, supprimer et déplacer du contenu dans un Drive partagé |
NONE | Enum | L'utilisateur ne dispose d'aucune autorisation pour le fichier ou le dossier. |
User
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
getDomain() | String | Récupère le nom de domaine associé au compte de l'utilisateur. |
getEmail() | String | Récupère l'adresse e-mail de l'utilisateur. |
getName() | String | Récupère le nom de l'utilisateur. |
getPhotoUrl() | String | Récupère l'URL de la photo de l'utilisateur. |