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

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

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

所有権

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

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

ファイル形式

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

Blob
Google Workspace ドキュメントとは異なり、未加工のバイナリ コンテンツまたはテキスト コンテンツ（画像、動画、PDF など）を含むファイル形式。 これはドライブの分類名であり、 JavaScript の Blob オブジェクトを指すものではありません。
フォルダ

ドライブ上の他の種類のファイルを整理するために使用できるコンテナ。フォルダはメタデータのみを含むファイルで、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 など）。 ドライブと 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）で管理します。これは、ファイルの権限のリストです。詳しくは、ファイル、フォルダ、ドライブを共有するをご覧ください。
変更履歴
ファイル メタデータではなく、ファイル コンテンツの変更の記録。 変更の詳細については、変更とリビジョンの概要をご覧ください。
サムネイル
ファイルのグラフィカルな表現。ドライブでは、一般的なファイル形式のサムネイルが自動的に生成されます。ドライブでレンダリングできないショートカットやその他のファイル形式の場合は、サムネイル画像を指定できます。詳しくは、サムネイルをアップロードするをご覧ください。

ファイルの整理

Drive API は、ファイルを spaces という保存場所と、corpora というコレクションに整理します。

スペース

互いに分離された特定の保存場所。ドライブ内のすべてのコンテンツは、drive と appDataFolder の 2 つの定義済みスペースのいずれかに保存されます。

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

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

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

Corpora

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

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

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

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

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

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

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