Google ドライブはファイルをコレクションごとに整理し、ファイルの種類ごとに説明して には、ファイル操作を容易にする、各ファイルの特定の属性が用意されています。
Google Drive API は、ドライブ上に保存されたファイルを
files
リソース。
所有権
ドライブは、ユーザーとファイル、フォルダ、 保存場所を指定します。コレクションは、ファイルのメタデータの一部として指定され、ドライブ内にファイルが保存されているファイルのグループを示します。マイドライブと 共有ドライブのコレクションはファイルのオーナー権限です。マイドライブ内のファイルのオーナーは 1 人のユーザーですが、共有ドライブ内のファイルのオーナーはグループまたは組織です。
- マイドライブ
- 各ユーザーには「root」「my-app」という ドライブ」主要な階層として機能します。 このルート フォルダの下位にあるすべてのものが含まれます。ユーザーがこのフォルダのメイン オーナーである。
- 共有ドライブとは、 組織構造は、Google ドライブと並行して マイドライブ。共有ファイル内の個々のファイルを整理できます。 どちらか一方のみを指定できます。ただし、ドライブ ショートカットを使用すると、共有ドライブからマイドライブ、またはその逆にファイルやフォルダを参照できます。
ファイル形式
ドライブでは、ファイルの種類ごとに記述されます。次のリストに、使用可能なすべてのファイル形式を示します。
- Blob
- 画像、動画、PDF などのテキストまたはバイナリ コンテンツを含むファイル。
- フォルダ
コンテナは、Google ドライブ上の他の種類のファイルを整理するために使用できる 。フォルダは、メタデータのみを含むファイルで、MIME タイプは
application/vnd.google-apps.folder
です。詳しくは フォルダを作成してデータを入力するをご覧ください。注: マイドライブに保存された 1 つのファイルは、複数の できます。1 つのファイルを共有ストレージ ドライブに設定できる親フォルダは 1 つのみです。
- Google Workspace ドキュメント
Google Workspace アプリケーションが Google ドキュメント、スプレッドシート、CSV などの スライド。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
というコレクションです。
- スペース
互いに分離された特定のストレージ ロケーション。すべてのコンテンツ ドライブは、次の 2 つの定義されたスペースのいずれかに保存されます:
drive
およびappDataFolder
。drive
: Drive で作成された、ユーザーに表示されるすべてのファイルが含まれます。PDF、ドキュメント、Google ドキュメント、ショートカット、ユーザーがアップロードしたその他のコンテンツは、drive
スペースに保存されます。appDataFolder
: ユーザーごとのアプリケーション データが含まれます。アプリケーション 通常は、構成ファイルなどのデータが保存されるのを ユーザーが直接アクセスできます。
spaces
間でファイルを移動できません。- Corpora
ファイルとフォルダの検索範囲を絞り込むために使用されるファイルのコレクション。「 ドライブのコーパスは
user
、domain
、drive
、およびallDrives
。user
: ユーザーが作成して [マイドライブ] で開いたファイル、および [共有アイテム] でユーザーと直接共有されているファイルが含まれます。drive
:driveId
で示されているように、単一の共有ドライブに含まれるすべてのファイルが含まれます。domain
: ユーザーのドメインで共有されている検索可能なすべてのファイルが含まれます。allDrives
: ユーザーがメンバーである共有ドライブ内のすべてのファイル、[マイドライブ] と [共有アイテム] 内のすべてのファイルが含まれます。allDrives
コーパスはスコープが広範であり、 パフォーマンスに影響します可能であれば、効率性を高めるためにallDrives
ではなくuser
またはdrive
を使用します。
権限とオーナー権限が変更されると、ファイルは
corpora
間で自由に移動できます。
関連トピック
必要に応じて次の手順を行います。
- 詳しくは、ファイルを作成、管理する方法をご覧ください。
- 詳しくは、フォルダを作成してデータを入力する方法をご覧ください。
- 詳しくは、ファイルデータをアップロードする方法をご覧ください。
- 詳しくは、ファイルのダウンロードとエクスポートをご覧ください。
- アプリケーション固有のデータを保存する方法を学習する。
- 詳しくは、ページに Google Picker を表示する方法をご覧ください。