ファイルの作成と管理

このガイドでは、Google ドライブでファイルを作成、管理する方法について説明します。

ファイルを作成

メタデータやコンテンツを含まないファイルをドライブに作成するには、パラメータを指定せずに files.create メソッドを使用します。このファイルには、kind の drive.file、id、name の「Untitled」、mimeType の application/octet-stream が与えられています。uploadType は必須としてマークされていますが、デフォルトは media であるため、実際に指定する必要はありません。

ドライブ ファイルの上限について詳しくは、ファイルとフォルダの上限をご覧ください。

メタデータのみのファイルを作成する

メタデータのみのファイルにはコンテンツが含まれていません。メタデータとは、ファイルを記述するデータ（name、mimeType、createdTime など）のことです。name などのフィールドはユーザーに依存せず、どのユーザーでも同じように表示されますが、viewedByMeTime などのフィールドにはユーザー固有の値が含まれます。

メタデータのみのファイルの例として、MIME タイプが application/vnd.google-apps.folder のフォルダがあります。詳細については、フォルダを作成して入力するをご覧ください。もう 1 つの例は、MIME タイプが application/vnd.google-apps.shortcut のドライブ上の別のファイルを指すショートカットです。詳しくは、ドライブ ファイルへのショートカットを作成するをご覧ください。

サムネイル画像を管理する

サムネイルはドライブのファイルを識別するのに役立ちます。ドライブでは、一般的なファイル形式のサムネイルを自動的に生成できます。また、アプリで生成されたサムネイル画像を使用することもできます。詳細については、サムネイルをアップロードするをご覧ください。

既存のファイルをコピーする

ファイルをコピーして、リクエストされた更新を適用するには、files.copy メソッドを使用します。コピーする fileId を見つけるには、files.list メソッドを使用します。

呼び出しを承認するには、適切な Drive API スコープを使用する必要があります。ドライブのスコープの詳細については、Google Drive API スコープを選択するをご覧ください。

制限事項と考慮事項

ファイルをコピーする準備をする際は、次の制限事項と考慮事項に留意してください。

  • 権限

    • copyRequiresWriterPermission ファイルの制限により、ファイルをコピーできるユーザーが決まります。詳細については、ユーザーがファイルをダウンロード、印刷、コピーできないようにするをご覧ください。
    • files リソースの capabilities/canCopy フィールドにより、ユーザーがファイルをコピーできるかどうかが決まります。詳細については、機能をご覧ください。
    • コピーを作成したユーザーは、コピーされたファイルのオーナーです。ソースファイルのその他の共有設定は複製されません。コピーが共有フォルダに作成された場合、そのフォルダの権限が継承されます。
    • コピーされたファイルの所有権が変更され、コピーが元のファイルの共有設定を継承しない場合があります。これらの設定のリセットが必要になる場合があります。

  • ファイル管理:

    • サードパーティのショートカットなど、一部のファイルはコピーできません。
    • ファイルは 1 つの親フォルダにのみコピーできます。複数の親を指定することはできません。parents フィールドが指定されていない場合、ファイルはソースファイルから検出可能な親を継承します。
    • フォルダはファイルの一種ですが、フォルダをコピーすることはできません。 代わりに、宛先フォルダを作成し、既存のファイルの parents フィールドを宛先フォルダに設定します。その後、元のソースフォルダを削除できます。
    • 新しいファイル名を指定しない限り、files.copy メソッドは元のファイルと同じ名前のファイルを生成します。
    • files.copy を過度に使用すると、Drive API の割り当て上限を超える可能性があります。詳細については、使用量上限をご覧ください。

次の手順をお試しください。