Google ドライブでは、ファイルをコレクションに整理してタイプ別にファイルを記述し、ファイル操作を容易にするために各ファイルに固有の属性を提供しています。
Google Drive API では、ドライブに保存されているファイルは File
リソースとして表されます。
オーナー権限
ドライブでは、ユーザーとコンテンツとの関係およびその保存場所に基づいてファイルが整理されます。コレクションはファイルのメタデータの一部として指定され、ファイルがドライブ内に保存されているファイルのグループを示します。マイドライブと共有ドライブのコレクションの主な違いは ファイルのオーナー権限です。1 人のユーザーがマイドライブ内のファイルのオーナーとなり、グループまたは組織は共有ドライブ内のファイルのオーナーとなります。
- マイドライブ
- 各ユーザーのプライマリ階層として機能する「マイドライブ」というルートフォルダは、そのルートフォルダの下位から構成されています。このユーザーは、このフォルダのメインのオーナーです。
- 共有ドライブ
- 共有ドライブは、マイドライブと並行して機能するドライブ内の組織構造です。共有ドライブとマイドライブの両方ではなく、個々のファイルを整理できます。ただし、 ドライブのショートカットを使用して、共有ドライブ内のファイルやフォルダ(またはその逆)を参照することができます。
ファイル形式
ドライブでは、ファイルが種類別に示されます。このリストには、使用可能なすべてのファイル形式が表示されます。
- Blob
- 画像、動画、PDF などのテキストまたはバイナリ コンテンツを含むファイル。
- フォルダ
ドライブ上の他の種類のファイルを整理するために使用できるコンテナ。フォルダはメタデータのみを含むファイルで、MIME タイプは
application/vnd.google-apps.folder
になります。注: マイドライブに保存されている 1 つのファイルを複数のフォルダに保存できます。共有ドライブに保存されている 1 つのファイルには、親フォルダを 1 つだけ含めることができます。
- ショートカット
ドライブ上の別のファイルを参照するメタデータのみのファイル。ショートカット ファイルの MIME タイプは
application/vnd.google-apps.shortcut
です。詳しくは、ドライブ ファイルへのショートカットを作成するをご覧ください。- サードパーティ製のショートカット
サードパーティのストレージ システムに保存されているコンテンツにリンクするメタデータのみのファイル。サードパーティ ショートカット ファイルの MIME タイプは
application/vnd.google-apps.drive-sdk
です。詳細については、外部ファイルへのショートカットを作成するをご覧ください。- Google Workspace ドキュメント
Google ドキュメント、スプレッドシート、スライドなど、Google Workspace アプリケーションが作成するファイル。MIME タイプの形式は
application/vnd.google-apps.*app*
です。ここで、app はアプリケーション名です(Google スプレッドシート ファイルの場合はapplication/vnd.google-apps.spreadsheet
など)。ドライブと Google Workspace 固有の MIME タイプの一覧については、Google Workspace と Google ドライブでサポートされる MIME タイプをご覧ください。
注: フォルダ、ショートカット、サードパーティのショートカット、Google Workspace のドキュメントをドライブとの間でアップロードまたはダウンロードすることはできません。ただし、互換性のある形式を使用している場合は、Google Workspace ドキュメントをアップロードまたはエクスポートできます。たとえば PDF をインポートして Google ドキュメントを作成できます。同様に、Google スライドのプレゼンテーションを Microsoft PowerPoint ファイルとしてエクスポートすることもできます。
ファイルの特性
ドライブのファイルの特性は次のとおりです。
- ファイル ID
- 各ファイルの一意の不透明な ID。ファイル ID は、ファイル名が変更されても、ファイルのライフサイクル中は不変です。検索式は、名前、タイプ、コンテンツ、親コンテナ、オーナー、その他のメタデータでファイルを検索するために使用されます。
- メタデータ
- ファイルの内容を記述するデータ。このデータには、名前、タイプ、作成時間、変更時間が含まれます。一部のメタデータ フィールド(
name
など)はユーザーに依存せず、どのユーザーでも同じように見えます。その他のフィールド(capabilities
やviewedByMeDate
など)にはユーザー固有の値が含まれます。画像や動画などのファイル形式には、EXIF やその他の埋め込みメタデータから抽出された追加のメタデータが含まれます。 - 権限
- ファイルまたはフォルダ階層にアクセスするためのユーザー、グループ、ドメイン、または全体に対するアクセス権。ユーザーは、ファイルの権限のリストであるアクセス制御リスト(ACL)を使用して、ファイルにアクセスできるユーザーを制御します。詳しくは、ファイル、フォルダ、ドライブを共有するをご覧ください。
- 充足感
- ファイルのバイナリまたはテキスト本文。Google ドライブに保存できるコンテンツの例には、画像、動画、テキスト、PDF などがあります。
- 変更履歴
- ファイル メタデータではなく、ファイル コンテンツのみに対する変更の記録。リビジョンの詳細については、変更とリビジョンの概要をご覧ください。
- サムネイル
- ファイルの図。ドライブは、一般的な多くのファイル形式のサムネイルを自動的に生成します。ショートカットや、ドライブでレンダリングできないその他のファイル形式については、サムネイル画像を提供できます。
ファイル整理
Drive API は、ファイルを spaces
という保存場所と corpora
というコレクションに整理します。
- スペース
互いに分離された特定のストレージ ロケーション。ドライブ内のすべてのコンテンツは、定義された 2 つのスペース(
drive
またはappDataFolder
)のいずれかに保存されます。drive
- ドライブで作成された、ユーザーに表示されるすべてのファイルが含まれます。ユーザーがアップロードした PDF、ドキュメント、Google ドキュメント、ショートカットなどのコンテンツは、drive
スペースに配置されます。appDataFolder
- ユーザーごとのアプリケーション データが含まれます。アプリは通常、ユーザーによる直接アクセスを意図していない構成ファイルなどのデータを保存します。
スペース間でファイルを移動することはできません。
- コーパス
ファイルとフォルダの検索範囲を絞り込むために使用されるファイルのコレクション。ドライブのコーパスは、
user
、domain
、drive
、allDrives
です。user
- [マイドライブ] でユーザーが作成したファイルと開いたすべてのファイルと、[共有アイテム] でユーザーと直接共有されているファイルが含まれます。drive
- 1 つの共有ドライブに含まれるすべてのファイルが含まれます(driveId
で示されます)。domain
- ユーザーのドメインで共有されている、検索可能なすべてのファイルが含まれます。allDrives
- ユーザーがメンバーである共有ドライブ内のすべてのファイルと、[マイドライブ] と [共有アイテム] 内のすべてのファイルが含まれます。allDrives
コーパスは、スコープが広く、パフォーマンスに影響する可能性があるため、慎重に使用してください。可能であれば、効率を高めるためにallDrives
ではなくuser
またはdrive
を使用してください。
権限や所有権の変更に応じて、コーパス間でファイルを自由に移動できます。
次のステップ
必要に応じて次の手順を行います。
- ドライブにファイルデータをアップロードする方法を確認する。
- ドライブからファイルをダウンロード、エクスポートする方法を確認する。
- アプリケーション固有のデータを保存する方法を確認する。
- ページに Google Picker を表示する方法をご確認ください。