比較

Comparison API の公式ドキュメントハブへようこそ。この API は、スプレッドシートのバージョン管理という面倒な作業を、開発者中心のシンプルなワークフローへと変換するために設計されています。四半期レポートを調整するデータアナリスト、予算改訂を追跡する財務チーム、あるいは大規模データパイプラインに diff 機能を組み込むソフトウェアエンジニアのいずれであっても、さまざまなスプレッドシート形式の変更点を直感的に把握できるよう支援します。基本的なモデルはシンプルです。Apple Numbers、CSV/TSV、もしくは一般的な Excel（.xlsx、.xls）のいずれかのソースファイルを 2 つ提供すれば、サービスは追加・削除・変更を明確なビジュアルでハイライトした単一の結果ファイルを返します。可視性は後付けではなく、セル背景の色分け、コメントバブル、行・列マーカーといったスプレッドシート固有の表記に合わせて差分を注記するため、ユーザーは好きなアプリで結果を開くだけで何が変わったかすぐに理解できます。基本的な diff に加えて、元の書式、数式、データ型も保持するため、出力は単なるテキストレポートではなく、さらなる分析や配布に使える完全なブックファイルです。セキュリティとパフォーマンスはすべてのリクエストに組み込まれており、ファイル転送は TLS 1.3 で行われ、処理はメモリ制限付きの隔離コンテナで実行されます。10 MB までのファイルは 1 秒未満で結果が返り、サイズが大きくなる場合はチャンクストリーミングでスムーズにスケールします。現在読んでいるドキュメントは、認証からリクエスト構築、エラーハンドリング・ページング・Webhook 統合といったベストプラクティスまで、数分で始められるよう構成されています。Python、JavaScript、Java、C# のコードサンプルが随所に掲載されており、1 行のコードでフル比較がトリガーできること、そしてブラウザ上で実ファイルを試せるサンドボックス環境も提供しています。このガイドを通じて、どんなワークフローにも信頼性の高い高精度スプレッドシート比較を組み込み、手作業のレビュー時間を短縮し、ステークホルダーに透明で監査可能な変更ログを提供できるようになります。安全で高速、しかも使いやすい API を活用してください。

主な機能

Comparison API は、スプレッドシートデータの統合時に多くの課題に対応する豊富な機能セットを備えています。まず第一に、Apple Numbers（.numbers）、CSV/TSV、レガシー Excel（.xls）、最新 Excel（.xlsx）といった多数のファイル形式をネイティブにサポートし、事前変換ツールが不要です。セルレベルでの diff エンジンは、値・数式・フォントスタイル・セルのシェーディング・データ検証ルールなどの書式属性の変化も検知し、カスタマイズ可能なカラーリングで分かりやすくハイライトします。大規模データセット向けには、増分比較モードを提供し、前回のベースライン以降に追加・変更された行だけを比較できるため、処理時間と帯域幅を削減できます。さらに、視覚的 diff ファイルに加えて、変更点を構造化した JSON サマリも取得でき、アラート通知やダッシュボード更新、バージョン管理システムへの連携といった自動化が容易になります。セキュリティ面では OAuth 2.0 ベアラートークン認証、スコープ付き API キー、オプションの IP ホワイトリストに加え、保存データは AES‑256 で暗号化され、GDPR と CCPA のコンプライアンス要件も満たしています。パフォーマンスは横方向スケーリングとインメモリ diff アルゴリズムにより最適化され、標準サイズのブックはほとんど 1 秒未満で完了し、50 MB を超えるファイルは Webhook による非同期処理で対応できます。開発者体験も重視しており、OpenAPI 仕様、自动生成 SDK、詳細なエラーコード、リアルタイムのレートリミットヘッダーが提供され、サンドボックスコンソールと豊富なサンプルリポジトリでバッチ処理、CI/CD パイプライン、サーバーレス関数への実装例が確認できます。要するに、Comparison API は高速・安全・開発者フレンドリーなスプレッドシート diff 機能を提供し、フォーマット・サイズ・複雑さを問わず 1 行の呼び出しで変更点を把握できるようにします。

ドキュメント

パラメータ

format: サポートされている出力ファイル形式です。
UploadFileRequest.OperationId: これは操作 ID です。
UploadFileRequest.Files: これらはオンラインサービスにアップロードする必要があるファイルです。独自の方法でデータを準備できますが、HTML の input ファイルの標準に従う必要があります。

エンドポイントを使用する

ファイルとアクセストークンを含むリクエストを送信する比較 API

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
サービスは処理されたファイルのダウンロード URL を返します。この例では以下の通りです：

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
ファイル名とフォルダ名を含むリクエストを送信し、ダウンロード API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
ファイルが受け取れます。使用するか、次のワークフローのステップに転送するだけです。