フォルダは、メタデータのみを含むファイルで、Google ドライブ内のファイルを整理するために使用できます。次のプロパティがあります。
- フォルダは、MIME タイプ
application/vnd.google-apps.folder
のファイルで、拡張子はありません。 - エイリアス
root
を使用すると、ファイル ID が指定されている任意の場所でルートフォルダを参照できます。
ドライブのフォルダの上限の詳細については、ファイルとフォルダの上限をご覧ください。
このガイドでは、フォルダに関連する基本的なタスクを実行する方法について説明します。
フォルダを作成
フォルダを作成するには、application/vnd.google-apps.folder
の mimeType
と name
を指定して files.create()
メソッドを使用します。次のコードサンプルは、クライアント ライブラリを使用してフォルダを作成する方法を示しています。
特定のフォルダにファイルを作成する
特定のフォルダにファイルを作成するには、files.create()
メソッドを使用して、ファイルの parents
プロパティにフォルダ ID を指定します。
parents
プロパティには、ファイルを含む親フォルダの ID が保持されます。parents
プロパティは、最上位フォルダまたは他のフォルダにファイルを作成する場合に使用できます。
ファイルの親フォルダは 1 つのみです。複数の親の指定はサポートされていません。parents
フィールドが指定されていない場合、ファイルはユーザーのマイドライブ フォルダに直接配置されます。
次のコードサンプルは、クライアント ライブラリを使用して特定のフォルダにファイルを作成する方法を示しています。
フォルダ間でファイルを移動する
ファイルを移動するには、parents
プロパティの ID を更新する必要があります。
既存のファイルの親を追加または削除するには、addParents
クエリ パラメータと removeParents
クエリ パラメータのいずれかを指定して files.update()
メソッドを使用します。
ファイルの親フォルダは 1 つのみです。複数の親の指定はサポートされていません。
次のコードサンプルは、クライアント ライブラリを使用してフォルダ間でファイルを移動する方法を示しています。
ファイルとフォルダの制限
ドライブのファイルとフォルダにはストレージの上限があります。
ユーザー アイテムの上限
各ユーザーは、そのアカウントで作成したアイテムを最大 5 億個保持することができます。上限に達すると、ユーザーはドライブでのアイテムの作成やアップロードができなくなります。ただし、既存のアイテムの閲覧や編集は引き続き行えます。ファイルを再び作成するには、アイテムを完全に削除するか、別のアカウントを使用する必要があります。詳細については、ファイルとフォルダをゴミ箱に移動または削除するをご覧ください。
この上限にカウントされるオブジェクトは次のとおりです。
- ユーザーがドライブで作成またはアップロードしたアイテム
- ユーザーが作成したが、現在は別のユーザーが所有しているアイテム
- ゴミ箱内のアイテム
- ショートカット
- サードパーティ製のショートカット
この上限にカウントされないオブジェクトは次のとおりです。
- 完全に削除されたアイテム
- ユーザーと共有されているが、他のユーザーが所有するアイテム
- ユーザーが所有するが、別のユーザーが作成したアイテム
5 億個を超えるアイテムを追加しようとすると、activeItemCreationLimitExceeded
HTTP ステータス コード レスポンスが返されます。
サービス アカウントが所有できるアイテムの数に上限はありませんが、サービス アカウントが作成できるアイテムの数には 5 億個の上限が適用されます。
フォルダアイテムの上限
ユーザーのマイドライブ内の各フォルダに保存できるアイテム数は 500,000 個までです。この上限はマイドライブのルートフォルダには適用されません。この上限にカウントされるアイテムは次のとおりです。
- フォルダ
- ファイルファイルのオーナー権限に関係なく、すべてのファイル形式。
- ショートカット。参照先のアイテムがそのフォルダ内にない場合でも、フォルダ内の 1 つのアイテムとしてカウントされます。詳細については、ドライブ ファイルへのショートカットを作成するをご覧ください。
- サードパーティ製ショートカット。参照先のアイテムがそのフォルダ内にない場合でも、フォルダ内の 1 つのアイテムとしてカウントされます。詳細については、アプリによって保存されたコンテンツへのショートカット ファイルを作成するをご覧ください。
フォルダの制限について詳しくは、Google ドライブ内のフォルダに関する制限事項をご覧ください。
フォルダの階層の深さの制限
ユーザーのマイドライブに含められるフォルダ階層は最大 100 レベルです。つまり、子フォルダを 99 階層を超えるフォルダの下に保存することはできません。この制限は子フォルダにのみ適用されます。application/vnd.google-apps.folder
以外の MIME タイプの子ファイルは、この制限の対象外です。
たとえば、次の図では、新しいフォルダをフォルダ番号 99 内にネストできますが、フォルダ番号 100 内にはネストできません。ただし、フォルダ番号 100 には、他のドライブ フォルダと同様にファイルを保存できます。
100 を超えるレベルのフォルダを追加しようとすると、myDriveHierarchyDepthLimitExceeded
HTTP ステータス コード レスポンスが返されます。