ファイルおよびフォルダの概要



  • この記事は、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がレンダリングすることができない他のファイルタイプの場合は、あなたはサムネイル画像を提供することができます。

次のステップ

これは、あなたがとるかもしれない少しの次のステップです: