Method: files.get

ID を指定してファイルのメタデータまたはコンテンツを取得します。

URL パラメータ alt=media を指定すると、レスポンスの本文にファイルの内容が含まれます。alt=media を使用してコンテンツをダウンロードできるのは、ファイルがドライブに保存されている場合のみです。Google ドキュメント、スプレッドシート、スライドをダウンロードするには、代わりに files.export を使用します。詳しくは、ファイルをダウンロードしてエクスポートするをご覧ください。

HTTP リクエスト

GET https://www.googleapis.com/drive/v3/files/{fileId}

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

パスパラメータ

パラメータ
fileId

string

ファイルの ID。

クエリ パラメータ

パラメータ
acknowledgeAbuse

boolean

既知のマルウェアやその他の不正なファイルをダウンロードするリスクをユーザーが認識しているかどうか。これは、alt パラメータが media に設定され、ユーザーがファイルのオーナーであるか、ファイルが存在する共有ドライブのオーガナイザーである場合にのみ適用されます。

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

includePermissionsForView

string

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

includeLabels

string

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

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には 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.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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