1 つまたは複数のファイルまたはフォルダーを ZIP ファイルに圧縮して保存し、単一のファイルとして機能させることができます。 ZIP アーカイブ はストレージ領域を節約し、コンピュータのパフォーマンスを向上させます。また、ZIP アーカイブ内のファイルとフォルダーをある場所から別の場所に効果的に転送することもできます。この記事では、Python の REST API を使用して ZIP ファイルのコンテンツを表示する方法を学びます。
この記事では次のトピックについて説明します。
- ZIP ファイル ビューア REST API および Python SDK
- Python の REST API を使用して HTML で ZIP ファイルを表示する
- ZIP アーカイブからの特定のフォルダーを HTML で表示
- ZIP ファイルのコンテンツを PDF でレンダリングする
- ZIP アーカイブを JPG にレンダリングする
- ZIP アーカイブからファイルとフォルダーのリストを取得する
ZIP ファイル ビューア REST API および Python SDK
ZIP アーカイブをレンダリングするには、GroupDocs.Viewer Cloud の Python SDK API を使用します。これにより、あらゆる種類の[一般的なドキュメント形式]をプログラムでレンダリングできるようになります3。コンソールで次のコマンドを使用してインストールしてください。
pip install groupdocs-viewer-cloud
上記の手順に従う前に、ダッシュボードからクライアント ID とシークレットを取得してください。 ID とシークレットを取得したら、以下に示すようにコードを追加します。
# このコード例は、コードにクライアント ID とシークレットを追加する方法を示しています。
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"
configuration = groupdocs_viewer_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
Python の REST API を使用して HTML で ZIP ファイルを表示する
以下に示す簡単な手順に従って、ZIP アーカイブを HTML でレンダリングできます。
- ZIPファイルをクラウドにアップロード
- ZIPをHTMLにレンダリング
- レンダリングされたHTMLファイルをダウンロード
ZIPファイルをアップロードする
まず、以下のコード例を使用して、ZIP ファイルをクラウドにアップロードします。
# このコード例は、ZIP ファイルをクラウドにアップロードする方法を示しています。
# APIのインスタンスを作成する
file_api = groupdocs_viewer_cloud.FileApi.from_config(configuration)
# ファイルのアップロード要求
request = groupdocs_viewer_cloud.UploadFileRequest("sample.zip", "C:\\Files\\Viewer\\sample.zip", my_storage)
# ファイルをアップロードする
response = file_api.upload_file(request)
その結果、アップロードされたファイルはクラウド上のダッシュボードの ファイル セクション で利用できるようになります。
Python で ZIP を HTML にレンダリングする
次に、以下の手順に従って、アップロードされた ZIP アーカイブのコンテンツをブラウザで表示します。
- まず、ViewAPIのインスタンスを作成します。
- 次に、viewoptions を定義し、アップロードされた ZIP ファイルのパスを指定します。
- 次に、ビュー\フォーマットを「HTML」に設定します。
- 必要に応じて、render\to\single\page を True に設定します。
- その後、viewoptionsを引数としてCreateViewRequestを作成します。
- 最後に、create\view() メソッドを使用して ZIP を HTML にレンダリングします。
次のコード サンプルは、Python の REST API を使用して ZIP ファイルを HTML でレンダリングする方法を示しています。
# このコード例は、ZIP ファイルを HTML にレンダリングする方法を示します。
# APIの初期化
apiInstance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# 表示オプションを無視する
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
view_options.view_format = "HTML"
# HTML オプションを定義する
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.render_to_single_page = True
# ビューリクエストの作成
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = apiInstance.create_view(request)
# 結果を示す
for page in response.pages:
print("Document path: " + page.path)
レンダリングされたファイルをダウンロードする
上記のコード サンプルは、レンダリングされた HTML ファイルをクラウドに保存します。次のコードサンプルを使用してダウンロードできます。
# このコード例は、レンダリングされたファイルをクラウドからダウンロードする方法を示しています。
# APIの初期化
file_api = groupdocs_viewer_cloud.FileApi.from_config(configuration)
# ダウンロードファイルリクエストの作成
request = groupdocs_viewer_cloud.DownloadFileRequest("viewer\\sample_zip\\sample_page_1.html", my_storage)
# ダウンロードファイル
response = file_api.download_file(request)
# ダウンロードしたファイルを作業ディレクトリに移動します
shutil.move(response, "C:\\Files\\Viewer\\")
ZIP アーカイブからの特定のフォルダーを HTML で表示
以下の手順に従って、ZIP ファイルの特定のフォルダーのみをブラウザーで表示することもできます。
- まず、ViewAPIのインスタンスを作成します。
- 次に、viewoptions を定義し、アップロードされた ZIP ファイルのパスを指定します。
- 次に、ビュー\フォーマットを「HTML」に設定します。
- 次に、ArchiveOptions を定義し、レンダリングするフォルダー名を指定します。
- その後、viewoptionsを引数としてCreateViewRequestを作成します。
- 最後に、create\view() メソッドを使用して、特定のフォルダーを ZIP から HTML にレンダリングします。
次のコード サンプルは、Python を使用して HTML の ZIP ファイルから特定のフォルダーをレンダリングする方法を示しています。
# このコード例は、特定のフォルダーを ZIP ファイルから HTML にレンダリングする方法を示します。
# APIの初期化
apiInstance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# 表示オプションを無視する
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
# アーカイブ オプションを定義する
view_options.render_options.archive_options = groupdocs_viewer_cloud.ArchiveOptions()
# フォルダー名を設定する
view_options.render_options.archive_options.folder = "ThirdFolderWithItems"
# ビューリクエストの作成
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = apiInstance.create_view(request)
# 終わり
for page in response.pages:
print("Document path: " + page.path)
ZIP ファイルのコンテンツを PDF でレンダリングする
以下に示す簡単な手順に従って、ZIP ファイルのコンテンツを PDF ドキュメントにレンダリングできます。
- まず、ViewAPIのインスタンスを作成します。
- 次に、viewoptions を定義し、アップロードされた ZIP ファイルのパスを指定します。
- 次に、表示形式を「PDF」に設定します。
- その後、viewoptionsを引数としてCreateViewRequestを作成します。
- 最後に、create\view() メソッドを使用してコンテンツを ZIP から PDF にレンダリングします。
次のコード サンプルは、Python の REST API を使用して ZIP ファイルのコンテンツを PDF でレンダリングする方法を示しています。
# このコード例は、ZIP ファイルを PDF にレンダリングする方法を示します。
# APIの初期化
apiInstance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# 表示オプションを無視する
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
view_options.view_format = "PDF"
# ビューリクエストの作成
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = apiInstance.create_view(request)
# ファイルパスを表示
print("Document path: " + response.file.path)
ZIP アーカイブを JPG にレンダリングする
以下の手順に従って、ZIP ファイルのコンテンツを JPG 画像としてレンダリングすることもできます。
- まず、ViewAPIのインスタンスを作成します。
- 次に、viewoptions を定義し、アップロードされた ZIP ファイルのパスを指定します。
- 次に、表示形式を「JPG」に設定します。
- その後、viewoptionsを引数としてCreateViewRequestを作成します。
- 最後に、create\view() メソッドを使用して ZIP を JPG にレンダリングします。
次のコード サンプルは、Python の REST API を使用して ZIP ファイルを JPG 画像でレンダリングする方法を示しています。
# このコード例は、ZIP ファイルを JPG にレンダリングする方法を示します。
# APIの初期化
apiInstance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# 表示オプションを無視する
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
view_options.view_format = "JPG"
# ビューリクエストの作成
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = apiInstance.create_view(request)
# ファイルパスを表示
print("Document path: " + response.file.path)
ZIP アーカイブからファイルとフォルダーのリストを取得する
以下の手順に従って、ZIP アーカイブからすべてのファイルとフォルダーのリストを取得できます。
- まず、InfoAPIのインスタンスを作成します。
- 次に、viewoptions を定義し、アップロードされた ZIP ファイルのパスを指定します。
- その後、viewoptionsを引数としてGetInfoRequestを作成します。
- 最後に、get\info() メソッドを使用して ZIP ファイルの内容を一覧表示します。
次のコード サンプルは、Python で ZIP ファイルからファイルとフォルダーのリストを取得する方法を示しています。
# このコード例は、ZIP ファイル内のファイルとフォルダーを一覧表示する方法を示します。
# APIの初期化
apiInstance = groupdocs_viewer_cloud.InfoApi.from_keys(client_id, client_secret)
# 表示オプションを無視する
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
# 情報取得リクエストを作成する
request = groupdocs_viewer_cloud.GetInfoRequest(view_options)
# 情報を取得
response = apiInstance.get_info(request)
# フォルダーの一覧表示
folders = response.archive_view_info.folders
for folder in folders:
print(folder)
# ファイルのリストを表示する
for attachment in response.attachments:
print(attachment.name)
オンラインで試す
上記の API を使用して開発された、次の無料のオンライン ZIP レンダリング ツールをお試しください。 https://products.groupdocs.app/viewer/zip
結論
この記事では、次の方法を学びました。
- Python で ZIP アーカイブまたは特定のフォルダーを ZIP から HTML にレンダリングします。
- ZIP ファイルの内容を PDF で表示します。
- ZIP アーカイブを JPG にレンダリングします。
- ZIP アーカイブのファイルとフォルダーをリストします。
- プログラムで ZIP ファイルをクラウドにアップロードします。
- レンダリングされた HTML ファイルをクラウドからダウンロードします。
さらに、ドキュメント を使用して、GroupDocs.Viewer Cloud API について詳しく学ぶことができます。また、ブラウザーを通じて直接 API を視覚化し操作できるようにする API リファレンス セクションも提供しています。不明な点がある場合は、フォーラムでお気軽にお問い合わせください。