変換

Metadata API は、1 つの HTTP リクエストでスプレッドシートファイルのメタデータを完全に制御できる、開発者フレンドリーな専用サービスです。Excel（.xlsx、.xls）や CSV（.csv）・TSV（.tsv）といったシンプルな区切りファイル、さらには Apple Numbers（.numbers）まで、ファイル解析の複雑さを抽象化し、数ミリ秒でキーとなる記述属性の読み取り、追加、変更が可能です。何千ものレポートや研究データセット、財務諸表を一括で処理し、作者情報、タイトル、サブジェクト、説明、キーワードリスト、カスタムタグといった一貫したメタデータを付与できることを想像してください。この自動化により手作業の編集時間が大幅に削減され、クライアントや協力者、アーカイブシステムに配布するすべてのファイルがインデックス作成、コンプライアンス、検索性に必要な正確なメタデータを保持します。サービスは生ファイルバイトまたはクラウド上のドキュメント URL を受け取り、元のデータレイアウトや数式を変更せずにメタデータ変更を適用した新しい完全なファイルを返します。

主な機能

APIはステートレスであるため、CI/CD パイプライン、サーバー側バッチジョブ、クライアント側 JavaScript ウィジェットに簡単に組み込むことができ、Web アプリからのエクスポートや定期的なバックアップのすべてに正しい由来情報が含まれることが保証されます。セキュリティは組み込み済みで、すべての呼び出しは TLS で行われ、ペイロードはエンドツーエンドで暗号化され、API キーまたは OAuth 2.0 認証がサポートされ、信頼できるサービスへのアクセスだけを許可できます。基盤エンジンは各フォーマットに最適化された解析ライブラリを利用しており、数百シートを持つ大規模な Excel ワークブックでも高速に処理され、典型的なリクエストは 200 ms 未満で完了します。これにより、ファイルをサービスに送信し、メタデータが付与されたバージョンを受け取り、インターフェースから離れずに即座にダウンロードできるシームレスな「Add Metadata」ボタンを製品内に実装できます。API は詳細な操作ログも返すため、開発者はプログラムで更新されたフィールドを検証し、必要に応じてロールバックしたり、カスタムタグの値に基づいて次の処理ステップをトリガーしたりできます。言語非依存の統一 REST エンドポイントを提供することで、開発者はフォーマット固有のライブラリを多数保守する必要がなくなり、保守コストが削減され、新しいスプレッドシート標準が出ても将来的な互換性が保証されます。SaaS ベンダーがライセンス情報を埋め込む場合、研究機関がデータセットをカタログ化する場合、企業がドキュメントコンプライアンスを自動化する場合など、あらゆるシナリオでこの API は高速・安全・スケーラブルにファイルを豊かにします。

ドキュメント

パラメータ

AppRequest.Metadata: PropertyName と PropertyValue を使用
AppRequest.MetadataJson: Metadata 構造を使用しない場合は、json データ型を使用する必要があります。
UploadFileRequest.OperationId: これらはオンラインサービスにアップロードする必要があるファイルです。独自の方法でデータを用意できますが、html input ファイルの標準に従う必要があります。
UploadFileRequest.Files: これらはオンラインサービスにアップロードする必要があるファイルです。独自の方法でデータを用意できますが、html input ファイルの標準に従う必要があります。

エンドポイントの使用

ファイルとアクセストークンを含むリクエストを送信しますメタデータ API

curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.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'
ファイルを受け取り、使用するか、ワークフローの次のステップに単に転送することができます。