Method: files.create

ファイルを作成します。詳しくは、ファイルを作成、管理するをご覧ください。

このメソッドは /upload URI をサポートします。次の特性を持つメディアのアップロードが可能です。

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

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
(deprecated)

boolean

非推奨: 複数のフォルダにファイルを作成することはサポートされなくなりました。
ignoreDefaultVisibility

boolean

作成されたファイルに対してドメインのデフォルトの公開設定を無視するかどうか。ドメイン管理者は、アップロードされたすべてのファイルをデフォルトでドメインに表示するように選択できます。このパラメータは、リクエストに対してその動作をバイパスします。権限は引き続き親フォルダから継承されます。
keepRevisionForever

boolean

新しいヘッド リビジョンで keepForever フィールドを設定するかどうか。これは、Google ドライブ内のバイナリ コンテンツを含むファイルにのみ適用されます。ファイルを削除しない状態で保存できるのは 200 個の版のみです。上限に達した場合は、固定されたリビジョンを削除してみてください。
ocrLanguage

string

画像インポート時の OCR 処理の言語ヒント（ISO 639-1 コード）。
supportsAllDrives

boolean

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

boolean

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

string

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

使用できる値は次のとおりです。

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

boolean

アップロードされたコンテンツをインデックス可能なテキストとして使用するかどうか。
includePermissionsForView

string

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

string

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

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