テキスト透かしを追加 - Excel API
PDF4me テキスト透かしを追加 カスタマイズ可能なテキスト透かしを追加できます Excel フォントスタイル、透明度、位置制御を備えたドキュメント。 API サービスプロセス Excel ファイルを作成し、セキュリティラベル、ブランディング、機密保持通知用のテキスト透かしを追加します。 API 受け取る Excel ドキュメントコンテンツ REST API 通話を利用して Base64 安全なデータ送信のためのエンコード。このソリューションは、文書のセキュリティ、ブランド保護、ステータス表示ワークフローに最適です。
関連ブログ記事
この機能に関するブログ記事はまだありません。近日公開予定です。
その間、PDF4me ブログを閲覧して、あらゆるプラットフォームのチュートリアルやワークフローをご覧ください。
ブログをご覧ください →
認証 API リクエスト
あなたの API 認証リクエストにキーを入力してください PDF4me REST API。
主な機能
- カスタムテキスト透かし: 任意のテキストを透かしとして追加します（例：「機密」、「下書き」）
- フォントのカスタマイズフォントの種類、サイズ、色を制御する
- 透明性管理半透明または完全に不透明なテキスト
- 配置オプション: 配置と位置合わせを制御する
REST API 終点
- 方法： POST
- 終点：
office/ApiV2Excel/ExcelAddWatermark
REST API パラメータ
重要： アスタリスク (*) が付いているパラメータは必須です。すべてのリクエストで使用されます。 書類、 ドキュメントコンテンツ、 そして addWatermarkToExcelAction操作固有のパラメータ（watermarkText、fontFamilyなど）は、アクションオブジェクトのプロパティです。
必須パラメータ（ルートレベル）
| パラメータ | 必須 | その機能 | 例 |
|---|---|---|---|
| document | Required | Source file. `Name` must end in `.xlsx`, `.xls` or `.xlsm` (a `.csv` for `ExcelParseCsv`). | { "Name": "data.xlsx" } |
| document.Name | Required | File name including its extension. Type: string. | { "Name": "data.xlsx" } |
| docContent | Required | The source file, base64-encoded. Type: string. | UEsDBBQABgAIAAAA... |
| isAsync | Optional | Process the request in the background. The call returns `202 Accepted`; poll the `Location` URL (`GetActionStatus`) for the result. Type: boolean. | |
| addWatermarkToExcelAction | Required | Object carrying this operation's settings. Its fields are the addWatermarkToExcelAction rows below. | See Payload example below |
| addWatermarkToExcelAction.watermarkText | Optional | The watermark text. Type: string. | |
| addWatermarkToExcelAction.fontFamily | Optional | Font name. Type: string. | |
| addWatermarkToExcelAction.textSize | Optional | `1` small, `2` medium, `3` large, `4` extra large. Type: integer. | |
| addWatermarkToExcelAction.isBold | Optional | Type: boolean. | |
| addWatermarkToExcelAction.isItalic | Optional | Type: boolean. | |
| addWatermarkToExcelAction.textColor | Optional | Hex color. Type: string. | |
| addWatermarkToExcelAction.transparency | Optional | `0` (opaque) to `100`. Type: integer. | |
| addWatermarkToExcelAction.rotationAngle | Optional | Rotation in degrees. Type: integer. | |
| addWatermarkToExcelAction.position | Optional | `0` top-left, `1` top-center, `2` top-right, `3` middle-left, `4` center, `5` middle-right, `6` bottom-left, `7` bottom-center, `8` bottom-right. Type: integer. | |
| addWatermarkToExcelAction.selectedWorksheetNames | Optional | Worksheet names. Type: array. | |
| addWatermarkToExcelAction.selectedWorksheetIndexes | Optional | 1-based worksheet numbers. Type: array. | |
出力
の API 返します Excel ドキュメントとして Base64-エンコードされた文字列 JSON フォーマット （ドキュメント、ファイル名、成功、エラーメッセージ）。
リクエスト例
ヘッダ
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
ペイロード（基本）
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addWatermarkToExcelAction": {
"watermarkText": "Confidential"
}
}