- この記事は、Google Drive™ APIに関する記事を和訳したものです。
- 原文: Files and folders overview
- 元記事のライセンスは CC-BYで、この和訳記事のライセンスは CC-BYです。
- 自己責任でご利用ください。
- 和訳した時期は 2019年6月ころです。
Google Driveは、ファイルをコレクションに整理し、タイプによってファイルを記述し、ファイル操作を容易にするためにそれぞれのファイルに固有の属性を提供します。
Google Drive上に格納されたファイルは、Drive APIにて File
リソースとしてあらわされます。
コレクション
Driveは、ユーザのコンテンツとの関係、およびそのストレージの位置に基づいて、コレクション内にファイルを組織します。 Collectionsは、Google Driveの内側に格納されたファイルのグループを示すためのファイルのメタデータの一部として指定されます。
My Drive
それぞれのユーザは "root" フォルダを持っています。 ユーザの "My Drive" は、彼らの主要な階層であり、このルートフォルダから派生されたすべてのものから構成されています。
Shared with me
"Shared with me" カテゴリは、自身および次のいずれかの他のユーザによって共有されたファイルを含んでいます: 直接現在のユーザに共有された、現在のユーザが含まれるグループ、あるいは、現在のユーザによってアクセスされた。
共有ドライブ
共有ドライブは、My Driveと並行して存在する、Google Drive内の組織高校です。 個々のファイルは、共有ドライブあるいは My Drive内に組織されるかもしれませんが、両方にはできません。
ファイルタイプ
Driveは、タイプによってファイルを記述します。 Google Drive上に格納テイルファイルタイプは {:type} です。
- Blob
- テキスト、あるいは、画像、動画、PDFといったバイナリコンテンツを含むファイル。
- Folder
-
Drive上の他のタイプのファイルを組織するために使用されるコンテナ。 フォルダは、
application/vnd.google-apps.folder
の MIMEタイプを伴うファイルです。 フォルダは、メタデータのみを含んでいます。備考: My Drive上に格納された単一のファイルは、複数のフォルダに含まれる可能性があります。 共有ドライブに格納された単一のファイルは、ひとつの親フォルダのみを持つことができます。
- Shortcut
-
サードパーティー製のストレージシステム上に格納されたコンテンツにリンクするファイル。 ショートカットファイルは、メタデータのみを含むことができ、
application/vnd.google-apps.drive-sdk
のファイルタイプを伴うファイルとして表されます。 - G Suite document
-
Google Docs, Sheet, Slidesといった G Suiteアプリケーションによって作成されたファイル。 これらのファイルはショートカットに似ており、appがアプリケーションの名前である形式
application/vnd.google-apps.*app*
の MIMEタイプを伴うファイルとして表されます。
備考:
フォルダ、ショートカット、および G Suite documentsは、Google Driveへアップロードすること、あるいは、そこからダウンロードすることができません。
しかしながら、G Suite documentsは、互換性のある形式を使用して、インポートする、あるいはエクスポートすることができるかもしれません。
例えば、Google Docは、PDFをインポートすることによって作成することができ、また、Google Slides presentationは .pptx
ファイルにエクスポートすることができます。
ファイル属性
以下は、Google Drive上に格納されたすべてのファイルに共通の要素のリストです:
- File ID
-
それぞれのファイルのための一意の不透明な ID。 ファイル IDは、もしファイル名が変更された場合でも、ファイルの存続期間を通して安定しています。
Drive内のファイルは、それらのパスを用いて直接アドレスされることができません。 検索式は、名前、タイプ、コンテンツ、親コンテナ、所有者、あるいは他のメタデータによってファイルを見つけるために使用されます。
- Metadata
-
ファイルのコンテンツ説明するデータ。 これは、名前、タイプ、作成および修正時刻を含んでいます。
name
といった幾つかのメタデータのフィールドは、ユーザに依存せず、それぞれのユーザに同じように表示されます。capabilities
およびviewedByMeDate
といった他のフィールドは、ユーザ固有の値を含んでいます。画像や動画といったファイルタイプは、EXIFから抽出された追加のメタデータ、および、他の組み込みメタデータを含んでいます。
- Permission
-
ファイルに課された制限。 アクセス制御リスト(ACL)、あるいは、ファイルのためのパーミッションのリストを使用して、ファイルにアクセスすることができるユーザを制御します、 ACLの詳細については、パーミッションについてを参照してください。
- Content
-
ファイルのバイナリ、あるいはテキストボディ。 画像、動画、テキストファイル、PDFは、Drive上に格納されたコンテンツの例です。
- Revision history
-
ファイルに加えられたすべての変更の履歴。
- Thumbnail
-
ファイルのグラフィカル表現。 Driveは、多くのファイルタイプのためのサムネイルを自動的に生成します。 ショートカット、あるいは Driveがレンダリングすることができない他のファイルタイプの場合は、あなたはサムネイル画像を提供することができます。
次のステップ
これは、あなたがとるかもしれない少しの次のステップです:
- Google Driveにファイルをアップロードする方法を学びます。
- Google Driveからファイルをダウンロードする方法を学びます。
- ウェブページに Google Driveファイルピッカーウィジェットを追加します。
- アプリケーション固有のデータを格納する方法を学びます。