ファイルやフォルダをゴミ箱に移動する、削除する

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 です。

ファイルとフォルダの上限

ドライブのファイルやフォルダ、共有ドライブ フォルダには、ストレージ制限があります。

一般的に、アイテム数の上限に達した後に空き容量を増やすには、アイテムを完全に削除するか、別のアカウントを使用する必要があります。ファイルをゴミ箱に移動しても、空き容量を増やすには不十分です。

ファイルとフォルダの上限について詳しくは、以下をご覧ください。