> ローカルにExcelをインストールする必要はありません。変換サーバーを維持する必要もありません。XLSX → PDF、Excel → CSV/JSON/images/HTMLを単純なREST呼び出しに変換し、約3分で最初の「クラウドスプレッドシートコンバーター」を実行できます。
「そのスプレッドシートを別の形式に変換する」は、日常の開発で最も一般的な要件の1つです。
- 財務および法務チームは、誰でも編集できる.xlsxの代わりに読み取り専用で改ざん防止されたPDFレポートを必要としています。
- データチームは、下流システムにCSV / JSONとして表形式データを引き出す必要があります。
- ウェブおよびモバイルアプリは、ワークシートやチャートを直接PNG / SVGにレンダリングしたいと考えています。
- ポータルは、埋め込むためのクリーンなHTML / HTMLテーブルスニペットを必要としています。
- 誰かが、.xls / .xlsx / .csv / .odsファイルの山を1つの形式に正規化する必要があります。
従来の回答は、マクロを使用したローカルExcelのインストールや、自分のサーバー上の重たいCOMコンポーネントでしたが、スケールするのが難しく、クロスプラットフォームで維持するのが困難です。Aspose.Cells Cloudは、すべてを純粋なREST APIに置き換えます：ファイルをアップロードし、新しい形式のファイルを取得します。
この記事では、Aspose.Cells CloudマイクロサービスのコアConversionControllerによって公開される3つの変換APIを、cURL、C#（.NET）、Python、Javaの実行可能な例とともに説明します。
—
## 1. Convert機能は何ができるか？
ConversionControllerは、_形式変換/エクスポート_に特化したコントローラーです。エンジンレベルの高忠実度変換を3セットのHTTP APIにラップしています。
| # | シナリオ | 一般的なエンドポイント | 何をするか |
| — | ———————————————————— | ———————————————— | —————————————————————————————————————————- |
| 1 | クラウドストレージにあるファイル → 新しい形式をダウンロード | GET /v4.0/cells/{name}?format=pdf | クラウドストレージ内のワークブックを直接変換し、結果をストリーミングで返します — 大きなファイルは決してあなたのマシンに移動しません |
| 2 | ローカルファイル → オンライン変換（ヘッドライン機能） | PUT /v4.0/cells/convert/spreadsheet?format=pdf | リクエストボディにファイルをアップロードします（マルチパート）；サーバーが変換し、結果ファイルを直接返します |
| 3 | クラウドファイル → 新しい形式として保存し、クラウドストレージに戻す | PUT /v4.0/cells/{name}/saveas?format=pdf | 変換されたファイルがクラウドストレージに直接書き込まれます — 自動化パイプラインに最適です |
> 実装ノート：ソースルートはv{version}/cellsというプレフィックスを使用し、APIバージョンは4.0です。したがって、ライブ呼び出しはhttps://api.aspose.cloud/v4.0/cells/...のようになります。
### 変換の粒度は「ファイル全体」を超えています
ワークブック全体を変換するだけでなく、コントローラーは_単一の要素_をエクスポートできます：
- 特定のワークシート → PDF / 画像 / CSV / JSON / HTML
- 特定のセル範囲（例：A1:C12） → PDF / 画像 / CSV / JSON / HTML
- 特定のテーブル → PDF / 画像 / CSV / JSON / HTML
- 特定のチャート → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF
したがって、1つのチャートを取得するために50 MBのワークブック全体を変換する必要はありません — 必要なものだけを変換し、帯域幅と計算を節約します。
—
## 2. サポートされている形式は？
コントローラーの組み込みExportDataレジストリに基づいて、変換マトリックスは大まかに次のようになります。
| タイプ | 形式 |
| —————————————– | ———————————————————————————————————————- |
| インポートおよびエクスポート（双方向） | XLS、XLSX、XLSB、XLSM、CSV、TSV、ODS、TXT |
| エクスポート専用 | PDF、OTS、XPS、DIF、HTML / MHTML、JSON、PNG、JPEG、BMP、SVG、TIFF、EMF、NUMBERS、FODS、Markdown、DOCX、PPTX、SQLなど。 |
要するに：スプレッドシートからスプレッドシートへのあらゆる種類の変換、さらにスプレッドシート → PDF / 画像 / ウェブデータ出力の全ファミリー — すべてが1つのAPIサーフェスの背後にあります。
—
## 3. 始める前に必要な2つのこと
1. Aspose Cloud Dashboardで無料アカウントを登録し、アプリケーションを作成してClient IDとClient Secretを取得します（SDKはこれらを自動的にJWTに交換します — 自分で認証ヘッダーを構築する必要はありません）。
2. お好みの言語用のSDKをインストールします：
xml
<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />
bash
# Python
pip install asposecellscloud
xml
<!-- Java（Maven） — 注意：Maven Centralにはないため、以下のAsposeリポジトリが必要です -->
<repositories>
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.cloud/repo/</url>
</repository>
</repositories>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-cells-cloud</artifactId>
<version>26.8</version>
</dependency>
> SDKは必要ありませんか？すべてが純粋なRESTなので、cURLも同様に機能します（以下を参照）。
—
## 4. シナリオ1：ローカルExcelファイルをオンラインで変換する（ヘッドラインConvert API）
これはPUT /v4.0/cells/convert/spreadsheet — フラッグシップ「Convert」APIです：ローカルファイルをリクエストボディにアップロードし、サーバーが変換して新しいファイルをストリーミングで返します。クラウドストレージに何も保存されず、アップロードコピーも残りません — 「これを変換してくれ」という瞬間に最適です。
### ① cURL
bash
# 1) まず、トークンを取得します
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET"
# 2) XLSX -> PDF
curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet?format=pdf" \
-H "Authorization: Bearer $TOKEN" \
-F "file=@Book1.xlsx" \
-o Book1.pdf
formatをcsv、json、png、xlsxに置き換えると、その形式が得られます。1つのパラメータ、1つの出力形式。
### ② C# / .NET
csharp
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Request;
var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
var request = new ConvertSpreadsheetRequest(
spreadsheet: "C:/invoices/Book1.xlsx", // ローカルファイルパス
format: "pdf"); // ターゲット：pdf / csv / json / png ...
using Stream result = cellsApi.ConvertSpreadsheet(request); // 変換されたファイルストリーム
using var outFile = File.Create("C:/invoices/Book1.pdf");
result.CopyTo(outFile);
// さらに簡単：SDKを出力パスにポイントしてファイルを書かせる
// cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf");
> バッチジョブが必要ですか？これをディレクトリ全体にループさせると、「フォルダ全体をXLSX → PDFに変換」できます。
### ③ Python
python
from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import ConvertSpreadsheetRequest
import os
instance = CellsApi(
os.getenv('CellsCloudClientId'),
os.getenv('CellsCloudClientSecret'))
# ローカルXLSX -> PDF、結果はローカルに書き込まれます
instance.convert_spreadsheet(
ConvertSpreadsheetRequest("Book1.xlsx", "pdf"),
local_outpath="Book1.pdf")
# 他の形式：パラメータを変更するだけです — json / csv / xlsx / png ...
### ④ Java
java
import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.request.ConvertSpreadsheetRequest;
import java.io.File;
public class ConvertDemo {
public static void main(String[] args) throws Exception {
CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
ConvertSpreadsheetRequest req = new ConvertSpreadsheetRequest();
req.setSpreadsheet("C:/invoices/Book1.xlsx"); // ローカルファイルパス
req.setFormat("pdf"); // ターゲット：pdf / csv / json / png ...
File out = api.convertSpreadsheet(req); // 変換された結果をファイルとして取得
out.renameTo(new File("C:/invoices/Book1.pdf"));
System.out.println("変換された: " + out.getAbsolutePath());
}
}
4つの言語、1つのアクション：パス + 形式パラメータを指定 → ターゲットファイルを取得。これがConvert APIの全ての売りです — 呼び出し側にExcelの依存関係はゼロ、テンプレートもCOMコンポーネントも不要です。
—
## 5. シナリオ2：クラウドに保存されたファイルを直接変換する
ファイルがすでにAspose Cloud Storage（またはオブジェクトストレージ）にある場合、大きなファイルをダウンロード/アップロードする必要はありません — 変換はクラウド内で行われ、データ転送を最小限に抑え、大きなワークブックのパフォーマンスを向上させます：
bash
# クラウドのBook1.xlsx -> PDF、ローカルにダウンロード
curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx" \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "format=pdf" \
--data-urlencode "folder=Reports" \
-o Book1.pdf
python
from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest
instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")
# クラウドに保存されたワークブックをPDFに直接変換
instance.export_spreadsheet_as_format(
ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports"))
特定の要素に掘り下げることもできます — たとえば、「Sheet1の3番目のチャート」をPNGとしてレンダリングする（クラウドストレージ版）：
bash
# チャート -> PNG
curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/worksheets/Sheet1/charts/2" \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "format=png" \
-o chart.png
クラウドエンドポイントの詳細は以下の通りです：
| ターゲット | エンドポイント | 例 format |
| —————- | ——————————————————- | —————————– |
| ワークブック全体 | GET /v4.0/cells/{name} | pdf / xlsx / csv / json |
| 単一ワークシート | GET /v4.0/cells/{name}/worksheets/{ws} | pdf / png / svg |
| 単一範囲 | GET /v4.0/cells/{name}/worksheets/{ws}/ranges/{range} | pdf / csv / json / html / png |
| 単一テーブル | GET /v4.0/cells/{name}/worksheets/{ws}/tables/{table} | pdf / csv / json / html / png |
| 単一チャート | GET /v4.0/cells/{name}/worksheets/{ws}/charts/{index} | pdf / png / jpeg / svg / tiff |
—
## 6. シナリオ3：SaveAs — 結果をクラウドストレージに書き戻す
変換されたファイルをクラウドストレージに保持したい場合は、PUT /v4.0/cells/{name}/saveasを使用します。「毎日今日のレポートをPDFにエクスポートしてアーカイブする」といった自動化に自然に適しています：
bash
curl -X PUT "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/saveas?format=pdf" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
python
from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import SaveSpreadsheetAsRequest
instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")
instance.save_spreadsheet_as(
SaveSpreadsheetAsRequest("Book1.xlsx", format="pdf", folder="Reports"))
# 結果はクラウドストレージに直接保存されます；CellsCloudResponse(Code=200, Status="OK")を返します
SaveOptionsDataリクエストボディを通じて詳細な保存オプションを渡すことができ、出力ファイル名、出力ストレージ、カスタムフォント、地域/ロケール、パスワードなどをクエリパラメータで制御できます — これらについては下記の_エンジニアリング詳細_で詳しく説明します。
—
## 7. さらに多くの用意された「オンライン変換」エンドポイント
上記のワークブックレベルの変換に加えて、コントローラーは完全なセットの専用ローカルファイル → 特定ターゲットエンドポイントを公開しています（シナリオ1と同じリクエストボディアップロード）。これらはより詳細で、帯域幅に優しいです：
| 目標 | エンドポイント（PUT、プレフィックス/v4.0/cells/convert/） |
| ———————————————— | ——————————————————————————————————– |
| ワークブック → PDF / JSON / CSV | spreadsheet/pdf、spreadsheet/json、spreadsheet/csv |
| ワークシート → PDF / JSON / CSV / HTML / HTMLテーブル | worksheet/pdf、worksheet/json、worksheet/csv、worksheet/html、worksheet/html-table |
| ワークシート → 画像 | worksheet/image?worksheet=Sheet1&format=png |
| 範囲 → PDF / CSV / HTML / JSON / 画像 | range/pdf、range/csv、range/html、range/json、range/image?worksheet=..&range=A1:C12&format=png |
| テーブル → PDF / CSV / HTML / JSON / 画像 | table/pdf、table/csv、table/html、table/json、table/image |
| チャート → 画像 / PDF | chart/image?worksheet=..&chartIndex=0&format=png、chart/pdf |
たとえば、「この範囲をCSVとしてエクスポートして下流システムに渡す」：
bash
curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv" \
-H "Authorization: Bearer $TOKEN" \
--data-urlencode "worksheet=Sheet1" \
--data-urlencode "range=A1:C100" \
-F "file=@data.xlsx" \
-o data.csv
これらのエンドポイントは、convert/spreadsheetと同じアップロードインボディパターンを使用します。 .NET SDKでは、チャートケースにはこれらのv4.0ルートにマッピングされた型付きラッパーがあります — ConvertChartToImage（convert/chart/image）およびConvertChartToPdf（convert/chart/pdf）。worksheet/*、range/*、およびtable/*のバリアントにはまだv4.0ラッパーがないため、上記のcURLと同じように純粋なRESTで呼び出す必要があります。
—
## 8. エンジニアリング詳細とエラー処理
### 知っておくべき変換オプション（クエリパラメータ）
- password — パスワード保護されたワークブックを開く。
- fontsLocation / カスタムフォントサポート — PDF/画像をレンダリングする際にグリフを正しく保持する。
- 行/列の自動調整、行/列見出しの印刷の有無（printHeadings）、地域/ページ設定（region）など。
- 出力側：outPath / outStorageNameは結果がクラウドストレージにどこに配置されるかを決定します。
### エラーコード（コントローラーが文書化する契約）
| ステータス | 意味 | 一般的な原因 |
| ——- | ———— | ———————————————————– |
| 400 | 不正なリクエスト | 無効なURL / パラメータ、またはサポートされていないformat |
| 401 | 認証失敗 | 認証に失敗したか、有効な資格情報が提供されていない |
| 404 | 見つかりません | ソースファイルがクラウドストレージでアクセスできない |
| 500 | サーバーエラー | サービスが変換データを取得する際に異常が発生しました |
### 認証
すべてのSDKはOAuth 2.0 client_credentialsとJWTで自動的に認証します。生のcURLを使用する場合は、最初に/connect/tokenを1回呼び出します（上記のシナリオ1、①を参照）。
—
## 9. なぜAspose.Cells Cloud Convertなのか？
- ✅ ローカル依存関係ゼロ — Office/Excel不要、COM不要。任意の言語および任意のプラットフォーム（Linux、コンテナ、サーバーレス）から呼び出せます。
- ✅ 高忠実度レンダリング — Aspose.Cellsエンジンによって駆動され、数式、チャート、スタイル、ページネーションがプロフェッショナル品質でPDF/画像にレンダリングされます。
- ✅ クラウドネイティブ — ファイルは変換中にクラウドに留まることができ、大きなペイロードを送信する必要がありません。純粋なオンライン変換はクラウドストレージを必要としません。
- ✅ 柔軟な粒度 — ワークブック / ワークシート / 範囲 / テーブル / チャート：必要な部分だけを正確に変換できます。
- ✅ SDK全体での一貫した形状 — cURL、.NET、Python、Javaの例は1:1でマッピングされているため、気に入ったパターンを文字通りコピーできます。
今すぐ始めましょう： Aspose Cloud Dashboardに登録し、アプリケーションを作成し、上記の任意のスニペットに資格情報を入力して実行します — 数分で独自の「クラウドExcelコンバーター」を手に入れることができます。
この記事が役に立ったと思ったら、スター、ブックマーク、または共有してください — そして、あなた自身のスプレッドシート変換のユースケースについてコメントで教えてください。
スプレッドシート変換をワンライナーにする：Aspose.Cells Cloud Convert API（.NET / Python / Java）の完全ガイド
スプレッドシート変換をワンライナーにする