ファイルのメタデータやコンテンツを更新します。このメソッドを呼び出す際は、変更したいリクエストのフィールドのみにデータを入力します。フィールドを更新すると、modifiedDate などの一部のフィールドが自動的に変更されることがあります。このメソッドは、パッチ セマンティクスをサポートしています。
このメソッドは /upload URI をサポートし、次の特性を持つアップロード済みのメディアを受け入れます。
- 最大ファイルサイズ: 5,120 GB
- 使用可能なメディア MIME タイプ:
*/*
注: リテラル */* 値ではなく、有効な MIME タイプを指定してください。リテラル */* は、任意の有効な MIME タイプをアップロードできることを示すためにのみ使用されます。
ファイルのアップロードの詳細については、ファイルデータをアップロードするをご覧ください。
HTTP リクエスト
- メディア アップロード リクエスト用のアップロード URI:
PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId} - メタデータ URI（メタデータのみのリクエストの場合）:
PATCH https://www.googleapis.com/drive/v3/files/{fileId}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
uploadType |
有効な値は次のとおりです。
|
fileId |
ファイルの ID。 |
クエリ パラメータ
| パラメータ | |
|---|---|
uploadType |
有効な値は次のとおりです。
|
addParents |
追加する親 ID のカンマ区切りのリスト。 |
enforceSingleParent |
非推奨: 複数のフォルダにファイルを追加することはサポートされなくなりました。代わりにショートカットを使用してください。 |
keepRevisionForever |
新しいヘッド リビジョンで「keepForever」フィールドを設定するかどうかを指定します。これは、Google ドライブ内にバイナリ コンテンツを含むファイルにのみ適用されます。ファイルのリビジョンを 200 まで永続的に保存できます。上限に達した場合は、固定されたリビジョンを削除してみてください。 |
ocrLanguage |
画像インポート時の OCR 処理の言語ヒント（ISO 639-1 コード）。 |
removeParents |
削除する親 ID のカンマ区切りのリスト。 |
supportsAllDrives |
リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうかを指定します。 |
supportsTeamDrives |
非推奨: 代わりに |
useContentAsIndexableText |
アップロードしたコンテンツをインデックス登録可能なテキストとして使用するかどうか。 |
includePermissionsForView |
レスポンスに含める追加のビューの権限を指定します。「published」のみがサポートされています。 |
includeLabels |
レスポンスの |
リクエスト本文
リクエストの本文には File のインスタンスが含まれています。
レスポンスの本文
成功した場合、レスポンスの本文には File のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.scripts
一部のスコープは制限されているため、アプリで使用するにはセキュリティ評価が必要です。詳細については、承認ガイドをご覧ください。