このサービスを使用すると、スクリプトで Google ドライブのファイルとフォルダを作成、検索、変更できます。
スクリプトで、デフォルトの Cloud プロジェクトではなく標準の Cloud プロジェクトを使用している場合は、Drive API を手動で有効にする必要があります。標準の Cloud プロジェクトで、Drive API を有効にします。
次のコードサンプルは、ユーザーのマイドライブ フォルダ内の各ファイルの名前をログに記録する方法を示しています。// 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());
}
クラス
名前 | 概要 |
---|---|
Access | ファイルまたはフォルダにアクセスできるユーザーのクラスと、明示的にアクセス権が付与されている個々のユーザーのクラスを表す列挙型。 |
DriveApp | スクリプトを使用して Google ドライブのファイルとフォルダを作成、検索、変更できます。 |
File | Google ドライブ内のファイル。 |
FileIterator | 大量のファイルが存在する可能性があるコレクションをスクリプトが反復処理できるようにするイテレータです。 |
Folder | Google ドライブ内のフォルダ。 |
FolderIterator | 大量のフォルダが存在する可能性があるコレクションに対してスクリプトで反復処理を行えるオブジェクト。 |
Permission | アクセス権を明示的に付与された個々のユーザーに加え、ファイルやフォルダにアクセスできるユーザーに付与される権限を表す列挙型。 |
User | Google ドライブのファイルに関連付けられているユーザー。 |
Access
プロパティ
プロパティ | 種類 | 説明 |
---|---|---|
ANYONE | Enum | インターネット上の誰でも検索してアクセスできます。 |
ANYONE_WITH_LINK | Enum | リンクを知っている全員がアクセスできます。 |
DOMAIN | Enum | ドメイン内のユーザーが検索してアクセスできます。 |
DOMAIN_WITH_LINK | Enum | リンクを知っているドメイン内のユーザーがアクセスできます。 |
PRIVATE | Enum | 明示的に権限を付与されたユーザーだけがアクセスできます。 |
DriveApp
プロパティ
プロパティ | 種類 | 説明 |
---|---|---|
Access | Access | ファイルまたはフォルダにアクセスできるユーザーのクラスと、明示的にアクセス権が付与されている個々のユーザーのクラスを表す列挙型。 |
Permission | Permission | アクセス権を明示的に付与された個々のユーザーに加え、ファイルやフォルダにアクセスできるユーザーに付与される権限を表す列挙型。 |
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | 前のイテレータの継続トークンを使用して、ファイルの反復処理を再開します。 |
continueFolderIterator(continuationToken) | FolderIterator | 前のイテレータの継続トークンを使用して、フォルダの反復処理を再開します。 |
createFile(blob) | File | 任意のデータの特定の Blob から、ユーザーのドライブのルートにファイルを作成します。 |
createFile(name, content) | File | 指定した名前とコンテンツで、ユーザーのドライブのルートにテキスト ファイルを作成します。 |
createFile(name, content, mimeType) | File | 指定された名前、コンテンツ、MIME タイプのファイルをユーザーのドライブのルートに作成します。 |
createFolder(name) | Folder | 指定した名前で、ユーザーのドライブのルートにフォルダを作成します。 |
createShortcut(targetId) | File | 指定されたドライブのアイテム ID へのショートカットを作成して返します。 |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | 指定されたドライブのアイテム ID とリソースキーへのショートカットを作成して返します。 |
enforceSingleParent(value) | void | アイテムの親に影響するすべての呼び出しに対する enforcingSingleParent の動作を有効または無効にします。 |
getFileById(id) | File | 指定された ID を持つファイルを取得します。 |
getFileByIdAndResourceKey(id, resourceKey) | File | 指定された ID とリソースキーを持つファイルを取得します。 |
getFiles() | FileIterator | ユーザーのドライブ内のすべてのファイルのコレクションを取得します。 |
getFilesByName(name) | FileIterator | ユーザーのドライブ内にある、指定した名前を持つすべてのファイルのコレクションを取得します。 |
getFilesByType(mimeType) | FileIterator | ユーザーのドライブ内にある、指定された MIME タイプのすべてのファイルのコレクションを取得します。 |
getFolderById(id) | Folder | 指定された ID のフォルダを取得します。 |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | 指定された ID とリソースキーを持つフォルダを取得します。 |
getFolders() | FolderIterator | ユーザーのドライブ内にあるすべてのフォルダのコレクションを取得します。 |
getFoldersByName(name) | FolderIterator | ユーザーのドライブ内にある、指定した名前を持つすべてのフォルダのコレクションを取得します。 |
getRootFolder() | Folder | ユーザーのドライブのルートにあるフォルダを取得します。 |
getStorageLimit() | Integer | ユーザーにドライブへの保存が許可されているバイト数を取得します。 |
getStorageUsed() | Integer | ユーザーが現在ドライブに保存しているバイト数を取得します。 |
getTrashedFiles() | FileIterator | ユーザーのドライブのゴミ箱内にあるすべてのファイルのコレクションを取得します。 |
getTrashedFolders() | FolderIterator | ユーザーのドライブのゴミ箱内にあるすべてのフォルダのコレクションを取得します。 |
searchFiles(params) | FileIterator | ユーザーのドライブ内にある、指定した検索条件に一致するすべてのファイルのコレクションを取得します。 |
searchFolders(params) | FolderIterator | ユーザーのドライブ内にある、指定した検索条件に一致するすべてのフォルダのコレクションを取得します。 |
File
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
addCommenter(emailAddress) | File | 指定したユーザーを File のコメント投稿者のリストに追加します。 |
addCommenter(user) | File | 指定したユーザーを File のコメント投稿者のリストに追加します。 |
addCommenters(emailAddresses) | File | 指定されたユーザー配列を File のコメント投稿者のリストに追加します。 |
addEditor(emailAddress) | File | 指定されたユーザーを File の編集者のリストに追加します。 |
addEditor(user) | File | 指定されたユーザーを File の編集者のリストに追加します。 |
addEditors(emailAddresses) | File | 指定されたユーザー配列を File の編集者のリストに追加します。 |
addViewer(emailAddress) | File | 指定されたユーザーを File の閲覧者リストに追加します。 |
addViewer(user) | File | 指定されたユーザーを File の閲覧者リストに追加します。 |
addViewers(emailAddresses) | File | 指定されたユーザー配列を File の閲覧者リストに追加します。 |
getAccess(email) | Permission | 指定されたユーザーに付与された権限を取得します。 |
getAccess(user) | Permission | 指定されたユーザーに付与された権限を取得します。 |
getAs(contentType) | Blob | このオブジェクト内のデータを、指定されたコンテンツ タイプに変換された blob として返します。 |
getBlob() | Blob | このオブジェクト内のデータを blob として返します。 |
getDateCreated() | Date | File が作成された日付を取得します。 |
getDescription() | String | File の説明を取得します。 |
getDownloadUrl() | String | ファイルのダウンロードに使用できる URL を取得します。 |
getEditors() | User[] | この File の編集者のリストを取得します。 |
getId() | String | File の ID を取得します。 |
getLastUpdated() | Date | File が最後に更新された日付を取得します。 |
getMimeType() | String | ファイルの MIME タイプを取得します。 |
getName() | String | File の名前を取得します。 |
getOwner() | User | ファイルのオーナーを取得します。 |
getParents() | FolderIterator | File の直接の親であるフォルダのコレクションを取得します。 |
getResourceKey() | String | リンクを使用して共有されているアイテムにアクセスするために必要な File のリソースキーを取得します。 |
getSecurityUpdateEligible() | Boolean | この File がリンクで共有されたときに、アクセスにリソースキーを必要とするセキュリティ アップデートの適用が可能かどうかを取得します。 |
getSecurityUpdateEnabled() | Boolean | この File がリンクで共有される場合、アクセスのためにリソースキーが必要かどうかを取得します。 |
getSharingAccess() | Access | 明示的にアクセス権が付与されている個々のユーザーに加えて、File にアクセスできるユーザーのクラスを取得します。 |
getSharingPermission() | Permission | 明示的にアクセス権が付与されている個々のユーザーに加え、File にアクセスできるユーザーに付与されている権限を取得します。 |
getSize() | Integer | ドライブに File を保存するために使用されるバイト数を取得します。 |
getTargetId() | String | ショートカットの場合は、キーが指しているアイテムの ID を返します。 |
getTargetMimeType() | String | ショートカットの場合、ポイントしているアイテムの MIME タイプを返します。 |
getTargetResourceKey() | String | ファイルがショートカットの場合は、それが指しているアイテムのリソースキーを返します。 |
getThumbnail() | Blob | ファイルのサムネイル画像を取得します。サムネイルが存在しない場合は null を取得します。 |
getUrl() | String | ドライブやドキュメントなどの Google アプリで File を開くために使用できる URL を取得します。 |
getViewers() | User[] | この File の閲覧者とコメント投稿者のリストを取得します。 |
isShareableByEditors() | Boolean | File に対する編集権限を持つユーザーに、他のユーザーと共有したり、権限を変更したりできるかどうかを決定します。 |
isStarred() | Boolean | ユーザーのドライブで File にスターが付いているかどうかを判断します。 |
isTrashed() | Boolean | File がユーザーのドライブのゴミ箱にあるかどうかを判断します。 |
makeCopy() | File | ファイルのコピーを作成します。 |
makeCopy(destination) | File | 宛先ディレクトリにファイルのコピーを作成します。 |
makeCopy(name) | File | ファイルのコピーを作成し、指定された名前で名前を付けます。 |
makeCopy(name, destination) | File | 宛先ディレクトリにファイルのコピーを作成し、指定された名前で名前を付けます。 |
moveTo(destination) | File | 指定された移動先のフォルダにこのアイテムを移動します。 |
removeCommenter(emailAddress) | File | File の閲覧者(コメント可)リストから指定したユーザーを削除します。 |
removeCommenter(user) | File | File の閲覧者(コメント可)リストから指定したユーザーを削除します。 |
removeEditor(emailAddress) | File | File の編集者のリストから指定されたユーザーを削除します。 |
removeEditor(user) | File | File の編集者のリストから指定されたユーザーを削除します。 |
removeViewer(emailAddress) | File | File の閲覧者とコメント投稿者のリストから、指定されたユーザーを削除します。 |
removeViewer(user) | File | File の閲覧者とコメント投稿者のリストから、指定されたユーザーを削除します。 |
revokePermissions(emailAddress) | File | 指定したユーザーに付与されている File へのアクセス権を取り消します。 |
revokePermissions(user) | File | 指定したユーザーに付与されている File へのアクセス権を取り消します。 |
setContent(content) | File | 指定した置換でファイルの内容を上書きします。 |
setDescription(description) | File | File の説明を設定します。 |
setName(name) | File | File の名前を設定します。 |
setOwner(emailAddress) | File | File のオーナーを変更します。 |
setOwner(user) | File | File のオーナーを変更します。 |
setSecurityUpdateEnabled(enabled) | File | リンクを使用して共有される場合、File がアクセスのためにリソースキーを必要とするかどうかを設定します。 |
setShareableByEditors(shareable) | File | File の編集権限を持つユーザーに、他のユーザーとの共有や権限の変更を許可するかどうかを設定します。 |
setSharing(accessType, permissionType) | File | 明示的にアクセス権を付与された個々のユーザーに加えて、File にアクセスできるユーザーのクラスと、これらのユーザーに付与される権限を設定します。 |
setStarred(starred) | File | ユーザーのドライブで File にスターを付けるかどうかを設定します。 |
setTrashed(trashed) | File | File がユーザーのドライブのゴミ箱にあるかどうかを設定します。 |
FileIterator
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
getContinuationToken() | String | この反復処理を後で再開するために使用できるトークンを取得します。 |
hasNext() | Boolean | next() を呼び出してアイテムを返すかどうかを決定します。 |
next() | File | ファイルまたはフォルダのコレクション内の次のアイテムを取得します。 |
Folder
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
addEditor(emailAddress) | Folder | 指定されたユーザーを Folder の編集者のリストに追加します。 |
addEditor(user) | Folder | 指定されたユーザーを Folder の編集者のリストに追加します。 |
addEditors(emailAddresses) | Folder | 指定されたユーザー配列を Folder の編集者のリストに追加します。 |
addViewer(emailAddress) | Folder | 指定されたユーザーを Folder の閲覧者リストに追加します。 |
addViewer(user) | Folder | 指定されたユーザーを Folder の閲覧者リストに追加します。 |
addViewers(emailAddresses) | Folder | 指定されたユーザー配列を Folder の閲覧者リストに追加します。 |
createFile(blob) | File | 任意のデータの特定の Blob から現在のフォルダにファイルを作成します。 |
createFile(name, content) | File | 指定された名前とコンテンツで、現在のフォルダにテキスト ファイルを作成します。 |
createFile(name, content, mimeType) | File | 指定された名前、コンテンツ、MIME タイプのファイルを現在のフォルダに作成します。 |
createFolder(name) | Folder | 現在のフォルダに、指定した名前でフォルダを作成します。 |
createShortcut(targetId) | File | 指定されたドライブのアイテム ID へのショートカットを作成して返します。 |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | 指定されたドライブのアイテム ID とリソースキーへのショートカットを作成して返します。 |
getAccess(email) | Permission | 指定されたユーザーに付与された権限を取得します。 |
getAccess(user) | Permission | 指定されたユーザーに付与された権限を取得します。 |
getDateCreated() | Date | Folder が作成された日付を取得します。 |
getDescription() | String | Folder の説明を取得します。 |
getEditors() | User[] | この Folder の編集者のリストを取得します。 |
getFiles() | FileIterator | 現在のフォルダの子であるすべてのファイルのコレクションを取得します。 |
getFilesByName(name) | FileIterator | 現在のフォルダの子であり、指定された名前を持つすべてのファイルのコレクションを取得します。 |
getFilesByType(mimeType) | FileIterator | 現在のフォルダの子で、指定された MIME タイプのすべてのファイルのコレクションを取得します。 |
getFolders() | FolderIterator | 現在のフォルダの子であるすべてのフォルダのコレクションを取得します。 |
getFoldersByName(name) | FolderIterator | 現在のフォルダの子であり、指定された名前を持つすべてのフォルダのコレクションを取得します。 |
getId() | String | Folder の ID を取得します。 |
getLastUpdated() | Date | Folder が最後に更新された日付を取得します。 |
getName() | String | Folder の名前を取得します。 |
getOwner() | User | この Folder のオーナーを取得します。 |
getParents() | FolderIterator | Folder の直接の親であるフォルダのコレクションを取得します。 |
getResourceKey() | String | リンクを使用して共有されているアイテムにアクセスするために必要な Folder のリソースキーを取得します。 |
getSecurityUpdateEligible() | Boolean | この Folder がリンクで共有されたときに、アクセスにリソースキーを必要とするセキュリティ アップデートの適用が可能かどうかを取得します。 |
getSecurityUpdateEnabled() | Boolean | この Folder がリンクで共有される場合、アクセスのためにリソースキーが必要かどうかを取得します。 |
getSharingAccess() | Access | 明示的にアクセス権が付与されている個々のユーザーに加えて、Folder にアクセスできるユーザーのクラスを取得します。 |
getSharingPermission() | Permission | 明示的にアクセス権が付与されている個々のユーザーに加え、Folder にアクセスできるユーザーに付与されている権限を取得します。 |
getSize() | Integer | ドライブに Folder を保存するために使用されるバイト数を取得します。 |
getUrl() | String | ドライブやドキュメントなどの Google アプリで Folder を開くために使用できる URL を取得します。 |
getViewers() | User[] | この Folder の閲覧者とコメント投稿者のリストを取得します。 |
isShareableByEditors() | Boolean | Folder に対する編集権限を持つユーザーに、他のユーザーと共有したり、権限を変更したりできるかどうかを決定します。 |
isStarred() | Boolean | ユーザーのドライブで Folder にスターが付いているかどうかを判断します。 |
isTrashed() | Boolean | Folder がユーザーのドライブのゴミ箱にあるかどうかを判断します。 |
moveTo(destination) | Folder | 指定された移動先のフォルダにこのアイテムを移動します。 |
removeEditor(emailAddress) | Folder | Folder の編集者のリストから指定されたユーザーを削除します。 |
removeEditor(user) | Folder | Folder の編集者のリストから指定されたユーザーを削除します。 |
removeViewer(emailAddress) | Folder | Folder の閲覧者とコメント投稿者のリストから、指定されたユーザーを削除します。 |
removeViewer(user) | Folder | Folder の閲覧者とコメント投稿者のリストから、指定されたユーザーを削除します。 |
revokePermissions(emailAddress) | Folder | 指定したユーザーに付与されている Folder へのアクセス権を取り消します。 |
revokePermissions(user) | Folder | 指定したユーザーに付与されている Folder へのアクセス権を取り消します。 |
searchFiles(params) | FileIterator | 現在のフォルダの子であり、指定された検索条件に一致するすべてのファイルのコレクションを取得します。 |
searchFolders(params) | FolderIterator | 現在のフォルダの子であり、指定された検索条件に一致するすべてのフォルダのコレクションを取得します。 |
setDescription(description) | Folder | Folder の説明を設定します。 |
setName(name) | Folder | Folder の名前を設定します。 |
setOwner(emailAddress) | Folder | Folder のオーナーを変更します。 |
setOwner(user) | Folder | Folder のオーナーを変更します。 |
setSecurityUpdateEnabled(enabled) | Folder | リンクを使用して共有される場合、Folder がアクセスのためにリソースキーを必要とするかどうかを設定します。 |
setShareableByEditors(shareable) | Folder | Folder の編集権限を持つユーザーに、他のユーザーとの共有や権限の変更を許可するかどうかを設定します。 |
setSharing(accessType, permissionType) | Folder | 明示的にアクセス権を付与された個々のユーザーに加えて、Folder にアクセスできるユーザーのクラスと、これらのユーザーに付与される権限を設定します。 |
setStarred(starred) | Folder | ユーザーのドライブで Folder にスターを付けるかどうかを設定します。 |
setTrashed(trashed) | Folder | Folder がユーザーのドライブのゴミ箱にあるかどうかを設定します。 |
FolderIterator
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
getContinuationToken() | String | この反復処理を後で再開するために使用できるトークンを取得します。 |
hasNext() | Boolean | next() を呼び出してアイテムを返すかどうかを決定します。 |
next() | Folder | ファイルまたはフォルダのコレクション内の次のアイテムを取得します。 |
Permission
プロパティ
プロパティ | 種類 | 説明 |
---|---|---|
VIEW | Enum | ファイルやフォルダにアクセスできるユーザーは、表示とコピーのみ可能です。 |
EDIT | Enum | ファイルやフォルダにアクセスできるユーザーは、そのファイルやフォルダを編集できます。 |
COMMENT | Enum | ファイルやフォルダにアクセスできるユーザーは、表示、コピー、コメントのみを行うことができます。 |
OWNER | Enum | ユーザーがファイルやフォルダのオーナーである。 |
ORGANIZER | Enum | 共有ドライブ内のファイルとフォルダを整理できるユーザー。 |
FILE_ORGANIZER | Enum | 共有ドライブ内でコンテンツを編集、ゴミ箱に入れ、移動できるユーザー。 |
NONE | Enum | ユーザーにファイルやフォルダに対する権限がありません。 |
User
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
getDomain() | String | ユーザーのアカウントに関連付けられているドメイン名を取得します。 |
getEmail() | String | ユーザーのメールアドレスを取得します。 |
getName() | String | ユーザーの名前を取得します。 |
getPhotoUrl() | String | ユーザーの写真の URL を取得します。 |