Method: files.update

ファイルのメタデータやコンテンツを更新します。このメソッドを呼び出す際は、変更したいリクエストのフィールドのみにデータを入力します。フィールドを更新すると、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

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 のカンマ区切りのリスト。
enforceSingleParent
(deprecated)

boolean

非推奨: 複数のフォルダにファイルを追加することはサポートされなくなりました。代わりにショートカットを使用してください。
keepRevisionForever

boolean

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

string

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

string

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

boolean

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

boolean

非推奨: 代わりに supportsAllDrives を使用してください。
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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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