Method: files.update

ファイルのメタデータやコンテンツを更新します。このメソッドを呼び出すときは、変更するリクエストのフィールドのみに値を設定します。フィールドを更新すると、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 構文を使用します。

パスパラメータ

パラメータ
fileId

string

更新するファイルの ID。

クエリ パラメータ

パラメータ
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

新しいリビジョンを固定するかどうか。ファイルに固定できるリビジョンは 200 個までです。

removeParents

string

削除する親 ID のカンマ区切りのリスト。

setModifiedDate

boolean

リクエスト本文で指定された値を使用して変更日を設定するか。このフィールドを true に設定した場合は modifiedDateBehavior=fromBodyOrNow と同じ動作になり、falsemodifiedDateBehavior=now と同じ動作になります。変更日セット modifiedDateBehavior=noChange が変更されないようにするため。

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

timedTextLanguage

string

字幕の言語。

timedTextTrackName

string

字幕トラックの名前。

updateViewedDate

boolean

ファイルの更新が正常に完了した後にビューの日付を更新するかどうか。

uploadType

string

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

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

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

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