メインコンテンツへスキップ
PDF4me API統合AIとSDK知識ベース拡張機能APIテスターブログ

画像ヘッダー/フッターを追加 - Excel API

PDF4me 画像ヘッダー/フッターを追加 カスタマイズ可能な画像ヘッダーとフッターを追加できます Excel 包括的な位置調整と書式設定制御を備えたドキュメント。 API サービスプロセス Excel ファイルを追加し、配置制御（ヘッダー/フッター）、水平方向の配置（左、中央、右）、ワークシートのターゲット設定（特定のシートまたはすべてのシート）、およびセンチメートル単位のページ余白を備えた画像ヘッダーまたはフッターを追加します。 API 受け取る Excel ドキュメントコンテンツと画像データ REST API 通話を利用して Base64 安全な送信のためのエンコード。 PNG、 JPG、 JPEGGIF画像フォーマットにも対応しており、このソリューションは企業ブランディング、専門的なレポート作成、文書自動化ワークフローに最適です。

関連ブログ記事
この機能に関するブログ記事はまだありません。近日公開予定です。
その間、PDF4me ブログを閲覧して、あらゆるプラットフォームのチュートリアルやワークフローをご覧ください。
ブログをご覧ください →

認証 API リクエスト​

あなたの API 認証リクエストにキーを入力してください PDF4me REST API。

Get your api Key

主な機能​

  • ヘッダーまたはフッターの配置: 画像を文書のヘッダーまたはフッターのどちらに配置するかを選択します。
  • 位置制御ヘッダー/フッター領域内で画像を左、中央、または右に配置
  • ワークシートのターゲット設定特定のワークシートに名前またはインデックスを指定して画像を適用するか、すべてのワークシートに適用します。
  • マージンカスタマイズ: ページの上下左右の余白をセンチメートル単位で設定します。
  • 画像フォーマットのサポート: PNG、 JPG、 JPEG、およびGIF形式

REST API 終点​

の PDF4me REST API 標準を使用する HTTP リソースとやり取りする方法。すべての画像ヘッダー/フッター操作 Excel 単一のエンドポイントを通じて実行されます。

  • 方法： POST
  • 終点： office/ApiV2Excel/ExcelAddImageHeaderFooter

REST API パラメータ​

重要： アスタリスク (*) が付いているパラメータは必須です。すべてのリクエストで使用されます。 書類、 ドキュメントコンテンツ、 画像コンテンツ （ルートレベル）そして addImageHeaderFooterToExcelActionその他のオプションは、アクションオブジェクトのプロパティです。

必須パラメータ（ルートレベル）​

パラメータ必須その機能例
documentRequiredSource file. `Name` must end in `.xlsx`, `.xls` or `.xlsm` (a `.csv` for `ExcelParseCsv`).{ "Name": "data.xlsx" }
document.NameRequiredFile name including its extension. Type: string.{ "Name": "data.xlsx" }
docContentRequiredThe source file, base64-encoded. Type: string.UEsDBBQABgAIAAAA...
isAsyncOptionalProcess the request in the background. The call returns `202 Accepted`; poll the `Location` URL (`GetActionStatus`) for the result. Type: boolean.
imageContentRequiredThe image, base64-encoded. Type: string.iVBORw0KGgoAAAANS...
addImageHeaderFooterToExcelActionRequiredObject carrying this operation's settings. Its fields are the addImageHeaderFooterToExcelAction rows below.See Payload example below
addImageHeaderFooterToExcelAction.isHeaderOptional`true` puts the image in the header, `false` in the footer. Type: boolean.
addImageHeaderFooterToExcelAction.positionOptionalHorizontal position. Type: string.
addImageHeaderFooterToExcelAction.worksheetNamesOptionalWorksheet names. Type: array.
addImageHeaderFooterToExcelAction.worksheetIndexesOptional1-based worksheet numbers. Type: array.
addImageHeaderFooterToExcelAction.topMarginOptionalTop page margin, in centimetres. Type: number.
addImageHeaderFooterToExcelAction.bottomMarginOptionalBottom page margin, in centimetres. Type: number.
addImageHeaderFooterToExcelAction.leftMarginOptionalLeft page margin, in centimetres. Type: number.
addImageHeaderFooterToExcelAction.rightMarginOptionalRight page margin, in centimetres. Type: number.

オプションパラメータ（addImageHeaderFooterToExcelAction内）​

注記： 両方 ワークシート名 そして ワークシートインデックス 空または null の場合、画像はすべてのワークシートに適用されます。 Excel ファイル。

出力​

の PDF4me 画像ヘッダー/フッターを追加 REST API 返します Excel ドキュメントとして Base64-エンコードされた文字列 JSON フォーマットバイナリデータとしてではなく。

同期処理（デフォルト）

の API リクエストを処理し、以下を返します。

ステータスコード: 200 OK

Content-Type: application/json

応答本文：

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "data.xlsx",
"success": true,
"errorMessage": null
}

回答欄:

  • 書類 (文字列): Excel 画像ヘッダー/フッターが適用されたドキュメント、エンコード済み Base64 弦
  • ファイル名 （文字列）：出力 Excel ファイル名
  • 成功 （ブール値）：リクエストが成功したかどうかを示します。
  • エラーメッセージ （文字列またはnull）：成功がfalseの場合のエラーの詳細

使用方法：

  1. 抽出する document からのフィールド JSON 応答 （Base64）
  2. 解読する Base64 バイナリを取得する文字列 Excel ドキュメントデータ
  3. 保存または処理 Excel 必要に応じてファイルする

例 （JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const excelBytes = atob(data.document); // Decode Base64
// Save or process excelBytes

リクエスト例​

ヘッダ​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

注記：

  • 手に入れよう API 鍵から PDF4me ダッシュボード
  • の API キーは Base64 エンコードされ、「Basic」がプレフィックスとして付加されています。 Authorization ヘッダー
  • 例: API 重要なのは abc123エンコードして Base64 そして使用する Authorization: Basic YWJjMTIz

ペイロード​

基本的な例（必須項目のみ）：

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
 "imageContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
 "addImageHeaderFooterToExcelAction": {}
}

高度な例（すべてのオプションフィールドを含む）：

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
 "imageContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
 "addImageHeaderFooterToExcelAction": {
 "isHeader": true,
 "position": "Center",
 "worksheetNames": ["Sheet1", "Report"],
 "worksheetIndexes": [1, 2],
 "topMargin": 1.9,
 "bottomMargin": 1.9,
 "leftMargin": 1.9,
 "rightMargin": 1.9,
 "cultureName": "en-US"
 }
}

コードサンプル​

の PDF4me 画像ヘッダーフッターを追加する Excel REST API 複数のプログラミング言語のコードサンプルを提供します。開発環境に最適な言語を選択してください。

C# (CSharp) サンプル

完了 C# 画像ヘッダー/フッターを追加するための実装 Excel 文書:

業界におけるユースケースとアプリケーション​

財務・会計におけるユースケース

  • 財務諸表四半期報告書に会社ロゴのヘッダーを追加する
  • 予算報告書予算ワークシートに部門ロゴを挿入する
  • 監査文書監査法人のロゴ透かしをフッターに適用する
  • 経費報告書経費精算申請書に企業ロゴのヘッダーを追加する

ヘルプが必要な場合​

Get Your API KeyAPI SamplesGetting Started