メタデータやコンテンツを含まないファイルを作成するには、パラメータを指定せずに 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
のドライブ上の別のファイルを指すショートカットです。詳しくは、ドライブ ファイルへのショートカットを作成するをご覧ください。
サムネイルをアップロードする
ドライブは、Google ドキュメント、スプレッドシート、スライドなど、一般的な多くのファイル形式のサムネイルを自動的に生成します。サムネイルは、ドライブのファイルを見分けやすくするのに役立ちます。
ドライブで標準サムネイルを生成できないファイル形式については、アプリケーションで生成されたサムネイル画像を使用できます。ファイルの作成時または更新時に、files
リソースの contentHints.thumbnail
フィールドを設定してサムネイルをアップロードします。
詳細:
contentHints.thumbnail.image
フィールドを、URL およびファイル名セーフの Base64 エンコード画像に設定します(RFC 4648 セクション 5 を参照)。contentHints.thumbnail.mimeType
フィールドをサムネイルの適切な MIME タイプに設定します。
ドライブでファイルからサムネイルを生成できる場合は、自動生成されたサムネイルが使用され、アップロードしたサムネイルは無視されます。サムネイルを生成できない場合は、指定されたサムネイルが使用されます。
サムネイルは次のルールに従う必要があります。
- PNG、GIF、JPG 形式でアップロードできます。
- 推奨される幅は 1,600 ピクセルです。
- 最小幅は 220 ピクセルです。
- 最大ファイルサイズは 2 MB です。
- 保存のたびにアプリケーションによって更新される必要があります。
詳細については、files
リソースをご覧ください。
関連トピック
次の手順をお試しください。
ファイルを作成または更新するときにファイルデータをアップロードするには、ファイルデータをアップロードするをご覧ください。
特定のフォルダにファイルを作成するには、特定のフォルダにファイルを作成するをご覧ください。