ファイルを作成します。詳しくは、ファイルを作成、管理するをご覧ください。
このメソッドは /upload URI をサポートします。次の特性を持つメディアのアップロードが可能です。
- 最大ファイルサイズ: 5,120 GB
- 有効なメディア MIME タイプ:
*/*（リテラル
*/*値ではなく、有効な MIME タイプを指定します。リテラル*/*は、有効な MIME タイプをアップロードできることを示すためにのみ使用されます。詳しくは、Google Workspace と Google ドライブでサポートされている MIME タイプをご覧ください）。
ファイルのアップロードの詳細については、ファイルデータをアップロードするをご覧ください。
create メソッドでショートカットを作成するアプリは、MIME タイプ application/vnd.google-apps.shortcut を指定する必要があります。
API を使用してファイルを挿入する場合、アプリは name プロパティでファイル拡張子を指定する必要があります。たとえば、JPEG ファイルを挿入するオペレーションでは、メタデータに "name": "cat.jpg" などを指定する必要があります。
後続の GET リクエストには、name プロパティで最初に指定された拡張機能が設定された読み取り専用の fileExtension プロパティが含まれます。Google ドライブのユーザーがファイルのダウンロードをリクエストした場合、または同期クライアントを介してファイルがダウンロードされた場合、ドライブは名前に基づいて完全なファイル名（拡張子付き）を作成します。拡張子がない場合、ドライブはファイルの MIME タイプに基づいて拡張子を特定しようとします。
HTTP リクエスト
- アップロード URI（メディアのアップロード リクエストの場合）:
POST https://www.googleapis.com/upload/drive/v3/files - メタデータ URI（メタデータのみのリクエストの場合）:
POST https://www.googleapis.com/drive/v3/files
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
| パラメータ | |
|---|---|
enforceSingleParent |
非推奨: 複数のフォルダにファイルを作成することはサポートされなくなりました。 |
ignoreDefaultVisibility |
作成されたファイルに対してドメインのデフォルトの公開設定を無視するかどうか。ドメイン管理者は、アップロードされたすべてのファイルをデフォルトでドメインに表示するように選択できます。このパラメータは、リクエストに対してその動作をバイパスします。権限は引き続き親フォルダから継承されます。 |
keepRevisionForever |
新しいヘッド リビジョンで |
ocrLanguage |
画像インポート時の OCR 処理の言語ヒント（ISO 639-1 コード）。 |
supportsAllDrives |
リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうか。 |
supportsTeamDrives |
非推奨: 代わりに、 |
uploadType |
使用できる値は次のとおりです。
|
useContentAsIndexableText |
アップロードされたコンテンツをインデックス可能なテキストとして使用するかどうか。 |
includePermissionsForView |
レスポンスに含める追加ビューの権限を指定します。 |
includeLabels |
レスポンスの |
リクエストの本文
リクエストの本文には File のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には File のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.file
一部のスコープは制限されており、アプリでそれらを使用するにはセキュリティ評価が必要です。詳しくは、承認ガイドをご覧ください。