Google ドライブのファイルやフォルダは、マイドライブと共有ドライブの両方から削除できます。これには、削除とゴミ箱の 2 つの方法があります。
ファイルやフォルダをゴミ箱に移動してから復元できます（ゴミ箱に移動してから 30 日以内）。ファイルやフォルダを削除すると、ドライブから完全に削除されます。一度に複数のファイルやフォルダをゴミ箱に移動、復元、完全削除すると、変更が反映されるまでに時間がかかることがあります。
このガイドでは、ドライブ内のファイルを破棄する方法について説明します。
ゴミ箱
ドライブのファイルを削除するには、ファイルをゴミ箱に移動します。ゴミ箱内のファイルは 30 日後に自動的に削除されます。30 日以内であれば、ゴミ箱からファイルを復元できます。
ファイルをゴミ箱に移動できるのはファイルのオーナーのみです。他のユーザーは、オーナーのゴミ箱にあるファイルを表示できません。所有していないファイルをゴミ箱に移動しようとすると、insufficientFilePermissions エラーが表示されます。詳細については、権限をご覧ください。
ファイルの所有者であることを確認するには、fileId パラメータと fields パラメータをブール値の ownedByMe フィールドに設定して files.get メソッドを呼び出します。共有ドライブ内のファイルは個々のユーザーではなく共有ドライブが所有しているため、ownedByMe フィールドは入力されません。fields パラメータを使用してフィールドを返す方法については、ファイルの特定のフィールドを返すをご覧ください。
自分がファイルのオーナーでない場合でも、削除したファイルのコピーが必要な場合は、次のいずれかの操作を行います。
- ファイルのコピーを作成します。
- オーナーに連絡して、ゴミ箱から復元してもらいます。
ファイルをゴミ箱に移動する
ファイルをゴミ箱に移動するには、files.update メソッドを使用して、trashed フィールドを True に設定します。共有ドライブのファイルをゴミ箱に移動するには、supportsAllDrives クエリ パラメータを True に設定する必要があります。詳細については、共有ドライブのサポートを実装するをご覧ください。
成功した場合、レスポンスの本文には files リソースのインスタンスが含まれます。
次のコードサンプルは、fileId を使用してファイルを削除済みとしてマークする方法を示しています。
Python
body_value = {'trashed': True}
response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()
Node.js
const body_value = {
'trashed': true
};
const response = await drive_service.files.update({
fileId: 'FILE_ID',
requestBody: body_value,
});
return response;
FILE_ID は、削除するファイルの fileId に置き換えます。
削除済みファイルのプロパティを取得する
ファイルがゴミ箱に移動された場合は、追加の files プロパティを取得できます。files.get メソッドを使用して、fields パラメータに次のフィールドを含めることができます。詳細については、ファイルの特定のフィールドを返すをご覧ください。
すべてのファイルについて、次のフィールドが入力されます。
trashed: ファイルが明示的にゴミ箱に移動されたか、ゴミ箱に移動された親フォルダから移動されたか。files.updateメソッドでtrashedを使用すると、ファイル ステータスが設定されますが、files.getメソッドはファイル ステータスを取得します。explicitlyTrashed: ファイルが親フォルダから再帰的にごみ箱に移動されたのではなく、明示的にごみ箱に移動されたかどうか。
次のフィールドは、共有ドライブ内のファイルに対してのみ入力されます。
trashedTime: アイテムがゴミ箱に移動された時間（RFC 3339 日付 / 時刻形式）。以前の Drive API v2 バージョンを使用している場合、このフィールドはtrashedDateと呼ばれます。trashingUser: ファイルが明示的にゴミ箱に移動された場合、そのファイルをゴミ箱に移動したユーザー。
ゴミ箱からファイルを復元する
ゴミ箱からファイルを復元するには、files.update メソッドを使用して、trashed フィールドを False に設定します。共有ドライブのファイルのゴミ箱を復元するには、supportsAllDrives クエリ パラメータを True に設定する必要があります。詳細については、共有ドライブのサポートを実装するをご覧ください。
成功した場合、レスポンスの本文には files リソースのインスタンスが含まれます。
次のコードサンプルは、fileId を使用してファイルをゴミ箱から復元する方法を示しています。
Python
body_value = {'trashed': False}
response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()
Node.js
const body_value = {
'trashed': false
};
const response = await drive_service.files.update({
fileId: 'FILE_ID',
requestBody: body_value,
});
return response;
FILE_ID は、復元するファイルの fileId に置き換えます。
ゴミ箱を空にする
files.emptyTrash メソッドを使用すると、ユーザーがゴミ箱に移動したすべてのドライブ ファイルを完全に削除できます。共有ドライブのゴミ箱を空にするには、driveId クエリ パラメータを共有ドライブ ID に設定する必要があります。
成功した場合、レスポンスの本文には空のインスタンスが含まれます。
次のコードサンプルは、fileId を使用してゴミ箱内のすべてのファイルを削除する方法を示しています。
Python
response = drive_service.files().emptyTrash().execute()
Node.js
const response = await drive_service.files.emptyTrash({
});
return response;
削除
ドライブ ファイルをゴミ箱に移動せずに完全に削除できます。ファイルを削除すると、共有相手は誰もそのファイルにアクセスできなくなります。他のユーザーが引き続きファイルにアクセスできるようにするには、削除する前にオーナー権限を譲渡してください。
共有ドライブのファイルを削除するには、ユーザーに親フォルダの role=organizer が必要です。フォルダを削除すると、ユーザーが所有するすべての子孫も削除されます。詳細については、権限をご覧ください。
ユーザーが所有するファイルをゴミ箱に移動せずに完全に削除するには、files.delete メソッドを使用します。共有ドライブのファイルを削除するには、supportsAllDrives クエリ パラメータを True に設定する必要があります。詳細については、共有ドライブのサポートを実装するをご覧ください。
成功した場合、レスポンスの本文には空のインスタンスが含まれます。
次のコードサンプルは、fileId を使用してファイルを削除する方法を示しています。
Python
response = drive_service.files().delete(fileId="FILE_ID").execute()
Node.js
const response = await drive_service.files.delete({
fileId: 'FILE_ID'
});
return response;
FILE_ID は、削除するファイルの fileId に置き換えます。
権限
次の表に、各オペレーションの実行に必要なロール権限を示します。ロールと、各ロールで許可されるオペレーションの完全なリストについては、ロールと権限をご覧ください。
| 許可されるオペレーション | owner |
organizer |
fileOrganizer |
writer |
commenter |
reader |
|---|---|---|---|---|---|---|
| ファイルやフォルダをゴミ箱に移動する | ✔ | ✔ | ✔ | |||
| ゴミ箱からファイルやフォルダを復元する | ✔ | ✔ | ✔ | |||
| ゴミ箱を空にする | ✔ | ✔ | ||||
| ファイルやフォルダを完全に削除する | ✔ | ✔ | ||||
| 共有ドライブのファイルやフォルダを削除する [*] | ✔ |
機能
files リソースには、ファイルに対してアクションを実行できるかどうかを示すために使用されるブール値の capabilities フィールドのコレクションが含まれています。
機能をチェックするには、fileId と fields パラメータを capabilities フィールドに設定して files.get メソッドを呼び出します。fields パラメータを使用してフィールドを返す方法については、ファイルの特定のフィールドを返すをご覧ください。
すべてのファイルについて、次のフィールドが入力されます。
capabilities.canTrash: 現在のユーザーがこのファイルをゴミ箱に移動できるかどうか。capabilities.canUntrash: 現在のユーザーがこのファイルをゴミ箱から復元できるかどうか。capabilities.canDelete: 現在のユーザーがこのファイルを削除できるかどうか。capabilities.canRemoveChildren: 現在のユーザーがこのフォルダから子を削除できるかどうか。アイテムがフォルダでない場合は false になります。
次のフィールドは、共有ドライブ内のファイルに対してのみ入力されます。
capabilities.canTrashChildren: 現在のユーザーがこのフォルダの子をゴミ箱に移動できるかどうか。アイテムがフォルダでない場合は false になります。capabilities.canDeleteChildren: 現在のユーザーがこのフォルダの子を削除できるかどうか。アイテムがフォルダでない場合は false になります。
ファイルとフォルダの制限
ドライブのファイルとフォルダ、共有ドライブのフォルダには、ストレージの制限があります。
通常、アイテムの上限に達した後に空き容量を増やすには、アイテムを完全に削除するか、別のアカウントを使用するしかありません。ファイルをゴミ箱に移動するだけでは、空き容量を増やすことはできません。
ファイルとフォルダの制限の詳細については、以下をご覧ください。