Google Drive API は、以下のような数種類のダウンロードおよびエクスポート操作をサポートしています。 次の表に示すリストをご覧ください。
オフライン |
|
|||
エクスポート |
|
ファイル コンテンツをダウンロードまたはエクスポートする前に、ユーザーが
Cloud Storage バケットの capabilities.canDownload
フィールドを使用して、
files
リソース。
このガイドの残りの部分では、これらのタイプを実行するための詳細な手順について説明します。 ダウンロードとエクスポートの アクションを実行できます
blob ファイルのコンテンツをダウンロードする
ドライブに保存されている blob ファイルをダウンロードするには、ダウンロードするファイルの ID を指定して files.get
メソッドを使用します。
alt=media
URL パラメータです。alt=media
URL パラメータは、
代替レスポンスとしてコンテンツのダウンロードがリクエストされていることをサーバーに通知する
使用できます。
alt=media
URL パラメータはシステム
パラメータ
すべての Google REST API で使用できます。クライアント ライブラリを
このパラメータを明示的に設定する必要はありません。
次のコードサンプルは、files.get
メソッドを使用して
Drive API クライアント ライブラリと併用できます。
Java
Python
Node.js
PHP
.NET
このコードサンプルでは、alt=media
URL パラメータを追加するライブラリ メソッドを使用します。
HTTP リクエストに渡します
アプリから開始されたファイルのダウンロードは、許可するスコープで承認する必要があります
読み取りアクセス権を付与する必要があります。たとえば、
drive.readonly.metadata
スコープには、ファイルの内容をダウンロードする権限がありません。
このコードサンプルでは、制限付きの「ドライブ」ファイル スコープを使用して、ユーザーが以下の操作を行えるようにします。
ドライブ ファイルのすべてを表示、管理できます。詳細情報
ドライブのスコープについては、Google Drive API を選択する
スコープ。
編集権限を持つユーザーは、読み取り専用ユーザーによるダウンロードを
copyRequiresWriterPermission
の設定
フィールドを false
に設定します。
以下として識別されたファイル
嫌がらせ行為者
(有害なソフトウェアなど)をダウンロードできるのは、ファイルのオーナーのみです。
また、get
クエリ パラメータ acknowledgeAbuse=true
を含める必要があります。
ダウンロードのリスクがあることをユーザーが承認したことを示す
望ましくないソフトウェアやその他の不正なファイル。アプリケーションはインタラクティブに
このクエリ パラメータを使用する前にユーザーに警告する。
部分ダウンロード
部分ダウンロードでは、ファイルの特定の部分のみをダウンロードします。マイページ
ファイルの中でダウンロードするファイルの部分を byte
範囲
を Range
ヘッダーに置き換えます。例:
Range: bytes=500-999
以前のバージョンで blob ファイルの内容をダウンロードする
以前のバージョンの blob ファイルの内容をダウンロードするには、
次の ID を持つ revisions.get
メソッド
ダウンロードするファイル、リビジョンの ID、alt=media
URL パラメータ。
alt=media
URL パラメータは、コンテンツのダウンロードが
代替レスポンス形式としてリクエストできます。files.get
と同様に、
revisions.get
メソッドは、省略可能なクエリ パラメータも受け入れます。
acknowledgeAbuse
と Range
ヘッダー。ダウンロードについて詳しくは、
詳しくは、ファイルのダウンロードと公開
できます。
ブラウザで blob ファイルのコンテンツをダウンロードする
ドライブに保存されている blob ファイルのコンテンツを、
API ではなく
webContentLink
フィールド
files
リソース。ユーザーがダウンロードした場合
ファイルとその内容をダウンロードするためのリンクが
返されます。ユーザーをこの URL にリダイレクトするか、クリック可能な URL として提供できます。
表示されます。
Google Workspace ドキュメントのコンテンツを書き出す
Google Workspace ドキュメントのバイト コンテンツをエクスポートするには、エクスポートするファイルの ID を指定して files.export
メソッドを使用します。
正しい MIME タイプを指定します。エクスポート済み
コンテンツのサイズは 10 MB に制限されています。
次のコードサンプルは、files.export
メソッドを使用して Cloud Storage バケットをエクスポートする方法を示しています。
Drive API クライアントを使用した PDF 形式の Google Workspace ドキュメント
ライブラリ:
Java
Python
Node.js
PHP
.NET
このコードサンプルでは、制限付きの drive
スコープを使用して、ユーザーによる閲覧と閲覧を許可する
管理する方法を学びました。詳細情報
ドライブのスコープについては、Google Drive API を選択する
スコープ。
このコードサンプルでは、エクスポート MIME タイプを application/pdf
として宣言しています。1 つの
各 Google Workspace でサポートされているすべてのエクスポート MIME タイプの完全なリスト
詳しくは、Google Workspace の MIME タイプを書き出す
ドキュメントをご覧ください。
ブラウザで Google Workspace ドキュメントのコンテンツを書き出す
ブラウザ内で Google Workspace ドキュメントのコンテンツを書き出すには、
exportLinks
フィールド
files
リソース。ドキュメントによって異なる
ファイルとその内容をダウンロードするためのリンクが MIME ごとに返されます。
使用できます。ユーザーを特定の URL にリダイレクトするか、
クリック可能なリンクです
ブラウザで Google Workspace ドキュメントのコンテンツを以前のバージョンにエクスポートする
以前のバージョンの Google Workspace ドキュメントのコンテンツを
revisions.get
メソッドを使用します。
ダウンロードするファイルの ID とリビジョンの ID に置き換えます。ユーザーが
ファイルへのダウンロード アクセス権、ファイルとその内容をダウンロードするためのリンクが
返されます。ユーザーをこの URL にリダイレクトするか、クリック可能な URL として提供できます。
表示されます。