Google ドライブでは、ファイルをコレクションに整理し、ファイルの種類でファイルを記述し、各ファイルに特定の属性を提供して、ファイルの操作を容易にします。
Google Drive API は、ドライブに保存されたファイルを files リソースとして表します。
所有権
ドライブでは、ユーザーとコンテンツの関係や保存場所に基づいてファイルが整理されます。コレクションは、ファイルが Google ドライブ内のどのファイル グループに保存されているかを示すために、ファイルのメタデータの一部として指定されます。マイドライブと共有ドライブ コレクションの主な違いは、ファイルの所有権です。マイドライブ内のファイルのオーナーは 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など）。ドライブと 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:driveIdで示されるように、1 つの共有ドライブに含まれるすべてのファイルが含まれます。domain: ユーザーのドメインと共有されている検索可能なすべてのファイルが含まれます。allDrives: ユーザーがメンバーになっている共有ドライブ内のすべてのファイルと、[マイドライブ] および [共有アイテム] 内のすべてのファイルが含まれます。allDrivesコーパスは範囲が広く、パフォーマンスに影響する可能性があるため、慎重に使用してください。効率化のため、可能な限りallDrivesではなくuserまたはdriveを使用します。
権限とオーナー権限が変更されると、ファイルは
corpora間を自由に移動できます。
関連トピック
必要に応じて次の手順を行います。
- ファイルを作成して管理する方法を学習する。
- フォルダを作成しデータを入力する方法を確認する。
- 詳しくは、ファイルデータをアップロードするをご覧ください。
- ファイルをダウンロードしてエクスポートする方法をご覧ください。
- アプリ固有のデータを保存する方法を学ぶ。
- ページに Google ピッカーを表示する方法について説明します。