このガイドでは、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 の割り当て上限を超える可能性があります。詳細については、使用量上限をご覧ください。
関連トピック
次の手順をお試しください。
ファイルを作成または更新するときにファイルデータをアップロードするには、ファイルデータをアップロードするをご覧ください。
特定のフォルダにファイルを作成するには、特定のフォルダにファイルを作成するをご覧ください。
ファイル メタデータを操作する。ファイル メタデータを管理するをご覧ください。
ファイルを削除するには、ファイルやフォルダをゴミ箱に移動または削除するをご覧ください。