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

Google ドライブのファイルやフォルダは、マイドライブと共有ドライブの両方から削除できます。削除と削除の 2 つの方法があります

ファイルやフォルダをゴミ箱に移動してから 30 日以内であれば復元できます。ファイルやフォルダを削除すると、ドライブから完全に削除されます。一度に複数のファイルやフォルダをゴミ箱に移動、復元、完全に削除すると、変更が反映されるまでに時間がかかることがあります。

このガイドでは、ドライブ内のファイルを破棄する方法について説明します。

ゴミの人

ドライブのファイルを削除するには、ファイルをゴミ箱に移動します。ゴミ箱内のファイルは 30 日後に自動的に削除されます。30 日以内であれば、ゴミ箱からファイルを復元できます。

ファイルをゴミ箱に移動できるのはファイルのオーナーのみです。他のユーザーはオーナーのゴミ箱内のファイルを表示できません。所有していないファイルをゴミ箱に移動しようとすると、insufficientFilePermissions エラーが発生します。詳細については、権限をご覧ください。

ファイルのオーナーであることを確認するには、fileId と fields パラメータをブール値 ownedByMe フィールドに設定して、files.get メソッドを呼び出します。共有ドライブ内のファイルは、個々のユーザーではなく共有ドライブによって所有されているため、ownedByMe フィールドは入力されません。fields パラメータを使用してフィールドを返す方法については、ファイルの特定のフィールドを返すをご覧ください。

ファイルのオーナーではないものの、ゴミ箱内のファイルのコピーが必要な場合は、次のいずれかを行います。

• ファイルのコピーを作成します。
• オーナーに連絡してゴミ箱から復元するよう依頼してください。

ファイルをゴミ箱に移動する

ファイルをゴミ箱に移動するには、files.update メソッドを使用して trashed フィールドを True に設定します。共有ドライブ ファイルをゴミ箱に移動するには、supportsAllDrives クエリ パラメータも True に設定する必要があります。詳しくは、共有ドライブのサポートを実装するをご覧ください。

成功した場合、レスポンスの本文には files リソースのインスタンスが含まれます。

次のコードサンプルは、fileId を使用してファイルをゴミ箱としてマークする方法を示しています。

body_value = {'trashed': True}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

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 を使用してファイルをゴミ箱に解除済みとしてマークする方法を示しています。

body_value = {'trashed': False}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

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 を使用してゴミ箱内のすべてのファイルを削除する方法を示しています。

response = drive_service.files().emptyTrash().execute()

 const response = await drive_service.files.emptyTrash({
    });
    return response;

削除

ドライブのファイルはゴミ箱に移動せずに完全に削除できます。ファイルを削除すると、共有相手はそのファイルにアクセスできなくなります。他のユーザーがファイルにアクセスできるようにする場合は、削除する前に他のユーザーにオーナー権限を譲渡してください。

共有ドライブ内のファイルを削除するには、親フォルダに対する role=organizer 権限が必要です。フォルダを削除すると、そのユーザーが所有する子孫もすべて削除されます。詳細については、権限をご覧ください。

ユーザー所有のファイルをゴミ箱に移動せずに完全に削除するには、files.delete メソッドを使用します。共有ドライブ ファイルを削除するには、supportsAllDrives クエリ パラメータも True に設定する必要があります。詳しくは、共有ドライブのサポートを実装するをご覧ください。

成功した場合、レスポンスの本文には空のインスタンスが含まれます。

次のコードサンプルは、fileId を使用してファイルを削除する方法を示しています。

response = drive_service.files().delete(fileId="FILE_ID").execute()

 const response = await drive_service.files.delete({
      fileId: 'FILE_ID'
    });
    return response;

FILE_ID は、削除するファイルの fileId に置き換えます。

権限

次の表に、各オペレーションの実行に必要な権限を示します。ロールの完全なリストと、各ロールで許可されるオペレーションについては、ロールと権限をご覧ください。

機能

files リソースには、ファイルに対してアクションを実行できるかどうかを示すために使用される、ブール値 capabilities フィールドのコレクションが含まれています。

機能を確認するには、fileId と fields パラメータを capabilities フィールドに設定して files.get メソッドを呼び出します。fields パラメータを使用してフィールドを返す方法については、ファイルの特定のフィールドを返すをご覧ください。

すべてのファイルで、次のフィールドに値が入力されます。

• capabilities.canTrash: 現在のユーザーがこのファイルをゴミ箱に移動できるかどうか。
• capabilities.canUntrash: 現在のユーザーがこのファイルをゴミ箱から復元できるかどうか。
• capabilities.canDelete: 現在のユーザーがこのファイルを削除できるかどうか。
• capabilities.canRemoveChildren: 現在のユーザーがこのフォルダから子を削除できるかどうか。アイテムがフォルダでない場合は false です。

次のフィールドは、共有ドライブ内にあるファイルについてのみ入力されます。

• capabilities.canTrashChildren: 現在のユーザーがこのフォルダの子をゴミ箱に移動できるかどうか。アイテムがフォルダでない場合は false です。
• capabilities.canDeleteChildren: 現在のユーザーがこのフォルダの子を削除できるかどうか。アイテムがフォルダでない場合は false です。

関連トピック

• Google ドライブのファイルを削除、復元する
• 共有ドライブと My Drive API の違い
• ロールと権限