Method: files.insert

新しいファイルを挿入します。

このメソッドは /upload URI をサポートし、以下の特性を持つアップロード済みメディアを受け入れます。

  • 最大ファイルサイズ: 5,120 GB
  • 使用可能なメディア MIME タイプ:*/*

注: リテラルの */* 値ではなく、有効な MIME タイプを指定してください。リテラル */* は、有効な MIME タイプをアップロードできることを示すためにのみ使用されます。

ファイルのアップロードについて詳しくは、ファイル データをアップロードするをご覧ください。

files.insert を使用してショートカットを作成するアプリでは、MIME タイプ application/vnd.google-apps.shortcut を指定する必要があります。

API を使ってファイルを挿入する際は、title プロパティ内でファイル拡張子を指定する必要があります。たとえば、JPEG ファイルを挿入するオペレーションでは、メタデータに "title": "cat.jpg" などを指定する必要があります。

後続の GET リクエストには、title プロパティに元々指定された拡張機能が入力された読み取り専用の fileExtension プロパティが含まれます。Google ドライブ ユーザーがファイルをダウンロードするようリクエストした場合、または同期クライアントを使用してファイルをダウンロードした場合、ドライブではタイトルに基づいて（拡張子を含む）完全なファイル名が作成されます。拡張子が指定されていない場合、ファイルの MIME タイプに基づいて拡張子が判別されます。

HTTP リクエスト

  • アップロード URI、メディア アップロード リクエストの場合:
    POST https://www.googleapis.com/upload/drive/v2/files
  • メタデータ URI（メタデータのみのリクエストの場合）:
    POST https://www.googleapis.com/drive/v2/files

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
uploadType

string

/upload URI へのアップロード リクエストのタイプ。/upload URI を使用してデータをアップロードする場合、このフィールドは必須です。メタデータのみのファイルを作成する場合、このフィールドは必須ではありません。また、ウィジェットはデータのアップロードに対応していないため、[このメソッドを試す] ウィジェットには表示されません。

有効な値は次のとおりです。

  • media - シンプル アップロード。メタデータのないメディアのみをアップロードします。
  • multipart - マルチパート アップロード。1 つのリクエストでメディアとメタデータの両方をアップロードします。
  • resumable - 再開可能アップロード。再開可能な方法でファイルをアップロードします。2 つ以上の連続するリクエストを使用します。最初のリクエストでメタデータを送信します。
convert

boolean

ファイルを対応するドキュメント エディタ形式に変換するかどうかを指定します。
enforceSingleParent
(deprecated)

boolean

非推奨: 複数のフォルダでのファイルの作成はサポートされなくなりました。
ocr

boolean

.jpg、.png、.gif、.pdf のアップロードのいずれかで OCR を実行するかどうか。
ocrLanguage

string

ocr が true の場合、使用する言語のヒント。有効な値は BCP 47 コードです。
pinned

boolean

アップロードしたファイルの Head リビジョンを固定するかどうかを指定します。ファイルに固定できる版は 200 個までです。
supportsAllDrives

boolean

リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうか。
supportsTeamDrives
(deprecated)

boolean

非推奨: 代わりに supportsAllDrives を使用してください。
timedTextLanguage

string

タイミング指定テキストの言語。
timedTextTrackName

string

時間指定テキスト トラック名。
useContentAsIndexableText

boolean

コンテンツをインデックス登録可能なテキストとして使用するかどうか。
visibility

enum (Visibility)

新しいファイルの公開設定。このパラメータは、convert=false の場合にのみ関係します。
includePermissionsForView

string

レスポンスに含める追加のビューの権限を指定します。published のみがサポートされています。
includeLabels

string

レスポンスの labelInfo 部分に含めるラベルの ID のカンマ区切りリスト。

リクエスト本文

リクエストの本文には File のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には File のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file

一部のスコープは制限されており、アプリで使用するにはセキュリティ評価が必要です。詳しくは、認可ガイドをご覧ください。