ファイルを作成する

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

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

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

メタデータのみのファイルにはコンテンツが含まれていません。メタデータとは、ファイルを記述するデータ(namemimeTypecreatedTime など)のことです。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 リソースをご覧ください。

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