ID でファイルのメタデータまたはコンテンツを取得します。実習をご覧ください。
URL パラメータ alt=media
を指定すると、レスポンスにファイルの内容が含まれます。alt=media
を使用したコンテンツのダウンロードは、ファイルが Google ドライブに保存されている場合にのみ機能します。Google ドキュメント、スプレッドシート、スライドをダウンロードするには、代わりに files.export
を使用してください。ファイルのダウンロードについて詳しくは、ファイルのダウンロードと書き出しをご覧ください。
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/drive/v3/files/fileId
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
パスパラメータ | ||
fileId |
string |
ファイルの ID。 |
省略可能なクエリ パラメータ | ||
acknowledgeAbuse |
boolean |
ユーザーが既知のマルウェアやその他の不正なファイルをダウンロードするリスクを認識しているかどうか。これは alt=media の場合のみ適用されます。(デフォルト: false )。 |
fields |
string |
レスポンスに含めるフィールドのパスです。指定しない場合は、このメソッドに固有のデフォルトのフィールド セットがレスポンスに含まれます。開発の場合、特別な値 * を使用してすべてのフィールドを返すことができますが、必要なフィールドのみを選択してパフォーマンスを向上させることができます。詳しくは、ファイルの特定のフィールドを返すをご覧ください。
|
includeLabels |
string |
レスポンスの labelInfo 部分に含めるラベルの ID のカンマ区切りのリスト。 |
includePermissionsForView |
string |
レスポンスに含める追加のビューの権限を指定します。「published」のみがサポートされています。 |
supportsAllDrives |
boolean |
リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうか。
(デフォルト: false )。 |
supportsTeamDrives |
boolean |
非推奨となった機能はサポート AllDrives を代わりに使用します。
(デフォルト: false )。 |
承認
このリクエストにより、次のスコープのうち少なくとも 1 つによる承認が可能になります。
範囲 |
---|
https://www.googleapis.com/auth/drive |
https://www.googleapis.com/auth/drive.file |
https://www.googleapis.com/auth/drive.readonly |
https://www.googleapis.com/auth/drive.metadata.readonly |
https://www.googleapis.com/auth/drive.appdata |
https://www.googleapis.com/auth/drive.metadata |
https://www.googleapis.com/auth/drive.photos.readonly |
一部のスコープは制限されているため、アプリで使用するにはセキュリティ評価が必要です。詳細については、認証と承認のページをご覧ください。
リクエスト本文
このメソッドをリクエストの本文に含めないでください。
レスポンス
デフォルトでは、レスポンスの本文で Files リソースが返されます。URL パラメータ alt=media
を指定すると、レスポンスにファイルの内容が含まれます。alt=media
を使用したコンテンツのダウンロードは、ファイルが Google ドライブに保存されている場合にのみ機能します。Google ドキュメント、スプレッドシート、スライドをダウンロードするには、代わりに files.export
を使用してください。ファイルのダウンロードについて詳しくは、ファイルのダウンロードと書き出しをご覧ください。
実習
以下の API Explorer を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。