ファイルとフォルダの概要

Google ドライブでは、ファイルをコレクションに整理し、ファイルの種類を記述し、ファイルの操作を容易にするために各ファイルに特定の属性を指定します。

Google Drive API は、ドライブに保存されているファイルを files リソースとして表します。

所有権

ドライブは、ユーザーとコンテンツの関係とその保存場所に基づいてファイルを整理します。コレクションは、ファイルのメタデータの一部として指定され、ドライブ内にファイルが保存されているファイルのグループを示します。マイドライブと共有ドライブ コレクションの主な違いは、ファイルの所有権です。マイドライブ内のファイルのオーナーは 1 人のユーザーですが、共有ドライブ内のファイルのオーナーはグループまたは組織です。

マイドライブ
各ユーザーには、メインの階層として機能する「マイ ドライブ」という「ルート」フォルダがあり、このルートフォルダから派生するすべてのフォルダで構成されています。ユーザーがこのフォルダのプライマリ オーナーである。
共有ドライブ
共有ドライブは、マイドライブと並行して存在するドライブ内の組織構造です。共有ドライブまたはマイドライブ内の個々のファイルを整理できますが、両方を整理することはできません。ただし、 ドライブ ショートカットを使用すると、共有ドライブからマイドライブ、またはその逆にファイルやフォルダを参照できます。

ファイル形式

ドライブでは、ファイルの種類ごとに記述されます。次のリストに、使用可能なすべてのファイル形式を示します。

Blob
画像、動画、PDF などのテキストまたはバイナリ コンテンツを含むファイル。
フォルダ

ドライブ上の他の種類のファイルを整理するために使用できるコンテナ。フォルダは、メタデータのみを含むファイルで、MIME タイプは application/vnd.google-apps.folder です。詳細については、フォルダを作成しデータを入力するをご覧ください。

注: マイドライブに保存されている 1 つのファイルは、複数のフォルダに存在できます。共有ドライブに保存されている 1 つのファイルに設定できる親フォルダは 1 つのみです。

Google Workspace のドキュメント

Google Workspace アプリケーション（Google ドキュメント、スプレッドシート、スライドなど）によって作成されたファイル。MIME タイプの形式は application/vnd.google-apps.*app* です。ここで、app はアプリケーション名です（スプレッドシート ファイルの場合は application/vnd.google-apps.spreadsheet など）。Drive と Google Workspace 固有の MIME タイプの一覧については、Google Workspace と Google ドライブでサポートされている MIME タイプをご覧ください。

ショートカット

ドライブ上の別のファイルを指すメタデータのみのファイル。ショートカット ファイルの MIME タイプは application/vnd.google-apps.shortcut です。詳細については、ドライブ ファイルへのショートカットを作成するをご覧ください。

サードパーティのショートカット

サードパーティのストレージ システムに保存されているコンテンツにリンクするメタデータのみのファイル。サードパーティのショートカット ファイルの MIME タイプは application/vnd.google-apps.drive-sdk です。詳細については、アプリによって保存されたコンテンツへのショートカット ファイルを作成するをご覧ください。

ファイルの特性

ドライブ ファイルの特徴を以下に示します。

アクセスに関する提案書
リクエスト元から承認者への提案。受信者にドライブ アイテムへのアクセス権を付与します。詳細については、保留中のアクセス提案を一覧表示して解決するをご覧ください。
コンテンツ
ファイルのバイナリまたはテキスト本文。ドライブに保存できるコンテンツの例としては、画像、動画、テキスト、PDF などがあります。
ファイル ID
ファイルごとに一意の不透明 ID。ファイル ID は、ファイル名が変更されても、ファイルの存続期間中は安定しています。検索式は、名前、タイプ、コンテンツ、親コンテナ、オーナー、その他のメタデータでファイルを検索するために使用されます。
メタデータ
ファイルの内容を記述するデータ。このデータには、名前、タイプ、作成時間、変更時間が含まれます。name などのメタデータ フィールドはユーザーに依存せず、ユーザーごとに同じように表示されます。capabilities や viewedByMeDate などの他のフィールドには、ユーザー固有の値が含まれます。画像や動画などのファイル形式には、EXIF やその他の埋め込みメタデータから抽出された追加のメタデータが含まれています。詳細については、ファイル メタデータを管理するをご覧ください。
権限
ファイルまたはフォルダ階層にアクセスするユーザー、グループ、ドメイン、またはすべてのユーザーに対するアクセス権の付与。ユーザーは、アクセス制御リスト（ACL）を使用して、ファイルにアクセスできるユーザーを制御します。ACL は、ファイルの権限のリストです。詳細については、ファイル、フォルダ、ドライブを共有するをご覧ください。
変更履歴
ファイル メタデータではなく、ファイル コンテンツに対する変更のみを記録します。リビジョンの詳細については、変更とリビジョンの概要をご覧ください。
サムネイル
ファイルをグラフィカルに表したものです。ドライブでは、一般的なファイル形式のサムネイルが自動的に生成されます。ドライブでレンダリングできないショートカットなどのファイル形式の場合は、サムネイル画像を指定できます。詳細については、サムネイルをアップロードするをご覧ください。

ファイル整理

Drive API では、ファイルを spaces というストレージ ロケーションと corpora というコレクションに整理します。

スペース

互いに分離された特定のストレージ ロケーション。Drive 内のすべてのコンテンツは、drive と appDataFolder の 2 つの定義済みスペースのいずれかに保存されます。

  • drive: Drive で作成された、ユーザーに表示されるすべてのファイルが含まれます。PDF、ドキュメント、Google ドキュメント、ショートカット、ユーザーがアップロードしたその他のコンテンツは、drive スペースに保存されます。

  • appDataFolder: ユーザーごとのアプリケーション データが含まれます。通常、アプリケーションは、ユーザーが直接アクセスすることを意図していない構成ファイルなどのデータを保存します。

spaces 間でファイルを移動することはできません。

Corpora

ファイルとフォルダの検索範囲を絞り込むために使用されるファイルのコレクション。ドライブのコーパスは、user、domain、drive、allDrives です。

  • user: ユーザーが作成して [マイドライブ] で開いたファイル、および [共有アイテム] でユーザーと直接共有されているファイルが含まれます。

  • drive: driveId で示されているように、単一の共有ドライブに含まれるすべてのファイルが含まれます。

  • domain: ユーザーのドメインと共有されている検索可能なファイルがすべて含まれます。

  • allDrives: ユーザーがメンバーである共有ドライブ内のすべてのファイル、[マイドライブ] と [共有アイテム] 内のすべてのファイルが含まれます。allDrives コーパスはスコープが広く、パフォーマンスに影響する可能性があるため、慎重に使用してください。可能であれば、効率性を高めるために allDrives ではなく user または drive を使用します。

権限とオーナー権限が変更されると、ファイルは corpora 間で自由に移動できます。

必要に応じて次の手順を行います。