作成、管理、保守: Aspose.Cells Cloud Management API の実践ガイド

空のワークブックを作成したり、シートの名前を変更したり、肥大化したファイルを圧縮したり、破損したファイルを修復したり――これらは、適切なツールがないときに開発者の時間を奪う小さな日常的作業です。ManagementController はそれらをワンライナーに変えます。

スプレッドシートを扱うすべてのアプリケーションは、最終的に同じ退屈な作業に直面します:

• 作成 新しい空のワークブックをその場で作成 — 時にはブランド化されたテンプレートから。
• ワークシートの再配置 — 追加、名前変更、削除、順序変更 — 昨日からデータの形が変わったため。
• ファイルサイズの抑制 — メール送信前に40 MBのXLSXを8 MBに圧縮。
• 破損ファイルの復旧 — ユーザーが誤って保存したものや、ツールが不適切にエクスポートしたもの。
• 構造の検査 — ワークブックを開かずに、どのシート、テーブル、チャート、結合セル領域が含まれているかを把握。

Aspose.Cells Cloud マイクロサービスの ManagementController（ソース: src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs）は、クリーンな REST インターフェイスの背後でこれらすべてを処理します。この投稿では、パイプラインにすぐ貼り付けて使用できる実行可能な cURL 例とともに、15 のエンドポイントを紹介します。

1. ManagementController は何をしますか？

ManagementController は、ワークブックのライフサイクルとハウスキーピング に特化したコントローラです。ConversionController（フォーマット変換）、DataProcessingController（バルクマージ/スプリット/インポート）、または CellsController（セルレベルの読み書き）とは異なり、このコントローラはワークブック自体の 形状、健全性、およびメタデータ に関するものです。

すべてのエンドポイントは、ワークブックをマルチパート入力（ローカル）として受け取るか、クラウドストレージに既に存在するもの（リモート）を参照し、変更されたワークブックストリーム、JSON ペイロード、またはシンプルな OK のいずれかを返します。

2. 15のエンドポイントをざっくりと

ルートはホスト https://api.aspose.cloud を前提としています。実際の呼び出しは https://api.aspose.cloud/v4.0/cells/... のようになります。

3. 開始する前に: 2つの前提条件

1. 資格情報を取得します。 Aspose Cloud Dashboard にサインアップし、アプリケーションを作成して Client ID と Client Secret を取得します。SDK は JWT の交換を自動で処理しますが、cURL を使用する場合は手動でベアラートークンと交換します。
2. SDK をインストール — または単に cURL を使用します。すべてはシンプルな REST です。

<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

4. クイックスタート: 新しいワークブックの作成

PUT /v4.0/cells/spreadsheet/create はコントローラが実行する最もシンプルな操作の一つで、最も有用なものでもあります。新しいブックファイルを返します。

cURL

# 1) Get a bearer token
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) Create an empty XLSX
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --output new_workbook.xlsx

テンプレートの使用

ブランド化されたテンプレート（ヘッダーのロゴ、テーマのブランドカラー、事前にフォーマットされた「Invoice」テーブル）がある場合は、クラウドストレージに一度アップロードし、そのパスを template として渡します。

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx&template=templates/invoice_branded.xlsx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --output invoice_2026_09_001.xlsx

これで、アプリケーションはスタイリングロジックを埋め込むことなく、すでに正しい外観の新しい請求書を作成できるようになります。

5. ウォークスルー: ワークブックのワークシートを管理する

これらの4つのエンドポイントは、ワークブックの日常的な形状を管理します。現実的なシーケンスを見てみましょう。ワークブックをアップロードし、そのシートを一覧表示し、新しいシートを追加し、既存のシートの名前を変更し、3番目のシートを削除する必要があります。

5a. ワークシートの一覧

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/worksheets" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@my_workbook.xlsx"

Response:

[
  { "WorksheetName": "Sheet1", "SheetType": "Worksheet" },
  { "WorksheetName": "Data", "SheetType": "Worksheet" },
  { "WorksheetName": "Chart1", "SheetType": "Chart" }
]

5b. 新しいワークシートを追加

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/add/worksheet?sheetType=Worksheet&position=1&sheetName=Summary" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5c. ワークシートの名前を変更する

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Sheet1&targetName=Overview" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5d. ワークシートを削除する

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/delete/worksheet?sheetName=Chart1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5e. ワークシートを移動する

# Move "Data" to position 0 (front of the workbook)
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/move/worksheet?worksheet=Data&position=0" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

これらのエンドポイントはすべて同じパターンに従います：マルチパートでワークブックをアップロードし、変更されたワークブックを取得します。パイプラインでチェーンするか、UIからアドホックに呼び出してください。

6. ウォークスルー: 肥大化したワークブックを圧縮

ユーザーが 40 MB の XLSX をメールで送ってきましたが、90 % が冗長な XML です。PUT /v4.0/cells/spreadsheet/compress を使用するとサイズが縮小されます。

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/compress?level=9" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@bloated.xlsx" \
  --output slim.xlsx

典型的な40 MBのワークブックでレベル9を使用すると、サイズはしばしば6〜10 MBの範囲になります。内容は同一で、XLSXコンテナのZIP圧縮が強化されているだけです。

7. ウォークスルー：破損したワークブックの修復

Excel が開くことを拒否するファイルを受け取ることがあります。PUT /v4.0/cells/spreadsheet/repair はエンジンの復旧ルーチンを実行し、クリーンなバージョンを返します。

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/repair" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@broken.xlsx" \
  --output repaired.xlsx

パラメータはありません。コントローラはエンジンを介してワークブックを再シリアライズし、破損した部分を破棄して構造的に有効なファイルを書き込みます。すべての破損が復元可能なわけではありませんが、一般的なケース — 切り捨てられたZIPエントリ、無効なセル参照、形式が不正な共有文字列 — を処理します。

8. 主な利点の概要

• ライフサイクル操作用の 1 つのコントローラ。 作成、再構築、圧縮、修復、検査 — すべてが 1 つの認証モデルと 1 つのエラー契約の下で行われます。
• テンプレート対応の作成。 アプリでスタイリングを再実装しないでください。サーバーがテンプレートを各新しいワークブックに組み込むようにします。
• ローカルとリモートのバリエーション。 ファイルがユーザーのブラウザ内にある場合でも、すでにクラウドストレージにある場合でも、ロジックは同じです。
• 構造のインスペクション。 structure エンドポイントは、シート、テーブル、ピボットテーブル、チャート、シェイプの完全な JSON マップを返します — UI や検証パイプラインを駆動するのに最適です。
• ゼロインフラストラクチャ。 Excel のインストール不要、COM 不要、維持するサーバーも不要です。