このページは Cloud Translation API によって翻訳されました。

Method: files.update

HTTP リクエスト
パスパラメータ
クエリパラメータ
リクエストの本文
レスポンスの本文
認可スコープ
試してみる

ファイルのメタデータやコンテンツを更新します。このメソッドを呼び出す際は、変更したいリクエストのフィールドのみにデータを入力します。フィールドを更新すると、modifiedDate などの一部のフィールドが自動的に変更されることがあります。このメソッドは、パッチセマンティクスをサポートしています。

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

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

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

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ

uploadType

string

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

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

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

fileId

string

更新するファイルの ID。

クエリパラメータ

パラメータ
`uploadType`	`string` `/upload` URI へのアップロードリクエストのタイプ。`/upload` URI を指定してデータをアップロードする場合、このフィールドは必須です。メタデータのみのファイルを作成する場合、このフィールドは必要ありません。また、このフィールドはデータのアップロードをサポートしていないため、[Try this method] ウィジェットには表示されません。有効な値は次のとおりです。 `media` - シンプルアップロード。メタデータのないメディアのみをアップロードします。 `multipart` - マルチパートアップロード。1 つのリクエストでメディアとメタデータの両方をアップロードします。 `resumable` - 再開可能なアップロード。再開可能な方法でファイルをアップロードします。2 つ以上の連続するリクエストを使用します。最初のリクエストでメタデータを送信します。
`addParents`	`string` 追加する親 ID のカンマ区切りのリスト。
`convert (deprecated)`	`boolean` 非推奨: このパラメータに関数はありません。
`enforceSingleParent (deprecated)`	`boolean` 非推奨: 複数のフォルダにファイルを追加することはサポートされなくなりました。`shortcuts` を代わりに使用してください。
`modifiedDateBehavior`	`enum (ModifiedDateBehavior)` `modifiedDate` を更新する動作を決定します。これは `setModifiedDate` をオーバーライドします。
`newRevision`	`boolean` blob のアップロードで新しいリビジョンを作成するかどうか。false の場合、現在のヘッドリビジョンの blob データが置換されます。true または未設定の場合、新しい blob がヘッドリビジョンとして作成され、以前の固定されていないリビジョンが短期間保持されます。固定されたリビジョンは、追加の保存容量を使用して、最大 200 リビジョンまで無期限に保存されます。版の保持方法について詳しくは、ドライブのヘルプセンターをご覧ください。
`ocr`	`boolean` .jpg、.png、.gif、.pdf のいずれかのアップロードで OCR を使用するかどうかを指定します。
`ocrLanguage`	`string` ocr が true の場合、使用する言語のヒントを示します。有効な値は BCP 47 コードです。
`pinned`	`boolean` 新しいリビジョンを固定するかどうか。1 つのファイルには最大 200 個のリビジョンを固定できます。
`removeParents`	`string` 削除する親 ID のカンマ区切りのリスト。
`setModifiedDate`	`boolean` リクエスト本文で指定された値を使用して更新日を設定するかどうかを指定します。このフィールドを `true` に設定すると `modifiedDateBehavior=fromBodyOrNow` と等価になり、`false` は `modifiedDateBehavior=now` と等価になります。更新日が変更されないようにするには、`modifiedDateBehavior=noChange` を設定してください。
`supportsAllDrives`	`boolean` リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうかを指定します。
`supportsTeamDrives (deprecated)`	`boolean` 非推奨: 代わりに `supportsAllDrives` を使用してください。
`timedTextLanguage`	`string` 読み上げるテキストの言語。
`timedTextTrackName`	`string` 再生タイミング指定テキストトラックの名前。
`updateViewedDate`	`boolean` ファイルが正常に更新された後に閲覧日を更新するかどうか。
`useContentAsIndexableText`	`boolean` コンテンツをインデックス登録可能なテキストとして使用するかどうか。
`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
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.scripts

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