ワークシートを抽出する Excel
PDF4me ワークシートを抽出する は REST 選択したシートを読み込むエンドポイント Excel ワークブックに書き込み、新しいワークブックコンテンツとして返します。 POST ファイルとして Base64 に office/ApiV2Excel/ExcelExtractWorksheetシートに名前を付けるか、0から始まるインデックスを一覧表示して、デコードされた結果を保存します。セレクターを送信しない場合は、すべてのワークシートが抽出されます。
ワークブックをシートごとに分割します。ファイル全体を一度送信し、分割したいシートを指定します。 extractWorksheetToExcelアクション: 正確なタブ名（大文字小文字を区別）、0 ベースのインデックス、またはその両方を同時に指定できます（結合が実行されます）。レポートの配布、チームごとの分割、および受信者が自分のシートのみを表示する必要があるワークフローにおいて、手動で右クリックして移動またはコピーする手順を置き換えます。
認証 API リクエスト
毎 PDF4me REST 電話にはあなたの API キー Authorization ヘッダーを基本認証として設定します。開発者ダッシュボードからキーを取得またはローテーションしてください。
終点
office/ApiV2Excel/ExcelExtractWorksheet見逃してはならない重要な事実
ワークシート名、 ワークシートインデックス、または両方。どちらかのリストに一致するシートが抽出されます。両方を省略すると、すべてのワークシートが抽出されますが、これは対象を絞った分割では望ましくない動作です。office/ApiV2Excel/ 同じホスト上、 /api/v2/.本体もネストされています:アクションオブジェクト(extractWorksheetToExcelアクション) 平坦なルートフィールドの代わりに。HTTP 設定
方法： POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet
コンテンツタイプ: アプリケーション/json
Authorization: 基本 <あなたの PDF4me API キー>
回答は JSON: チェック success フラグを立てて、それから Base64返されたワークブックの内容をデコードして保存します。 .xlsx 拡大。
どのシートが抽出されるか：名前か、それとも索引か？
選択は宣言型です。並べ替えやループ処理は一切不要です。対象シートを一度記述すれば、エンジンがワークブックに対してそれらを解決します。
| 名前とインデックス | 送信 | 抽出されるもの |
|---|---|---|
| 名前のみ | "worksheetNames": ["Sheet1", "Summary"] | タブ名が完全に一致するシート（大文字と小文字を区別） |
| 索引のみ | "worksheetIndexes": [0, 2] | 0から始まる位置にあるシート |
| 両方 | 名前＋索引 | 組合: どちらかのリストに一致するもの |
| どちらでもない | {} アクションオブジェクト | ワークブック内のすべてのワークシート |
API ボディフィールド
| パラメータ | 必須 | その機能 | 例 |
|---|---|---|---|
| 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. | |
| extractWorksheetToExcelAction | Required | Object carrying this operation's settings. Its fields are the extractWorksheetToExcelAction rows below. | { "worksheetNames": [...] } |
| extractWorksheetToExcelAction.worksheetNames | Optional | Comma-separated worksheet names. Type: string. | |
| extractWorksheetToExcelAction.worksheetIndexes | Optional | Comma-separated 1-based worksheet numbers, e.g. `"1,3"`. Type: string. | |
サンプルペイロード
名前で2枚のシートを抽出する
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetNames": ["Sheet1", "Summary"]
}
}
0ベースのインデックスによる抽出
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetIndexes": [0, 2]
}
}
郵便配達員の集荷に関するヒント
curlの例
curl -X POST https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_API_KEY" \
-d '{
"document": { "Name": "data.xlsx" },
"docContent": "'"$(base64 -w 0 data.xlsx)"'",
"extractWorksheetToExcelAction": {
"worksheetNames": ["Summary"]
}
}' \
--output response.json
何が API 戻る？
A JSON 抽出結果を記述し、新しいワークブックの内容を保持する Base64。
| 分野 | タイプ | 内容物 |
|---|---|---|
document / documents | String (Base64) / Array | The extracted workbook content. A single extraction returns one document; multi-sheet extraction can return an array, so handle both shapes. |
fileName | String | Output filename for the extracted workbook. |
success | Boolean | true when extraction succeeded. Check this before decoding content. |
errorMessage | String | Populated when success is false; explains what went wrong. |
コードサンプル
Excel オフィスエンドポイントはまだパーlanguage サンプルフォルダ。サンプルリポジトリには、すべてのサンプルで使用されるリクエストパターンが含まれています。 PDF4me エンドポイントファミリー:
よくある質問
ワークシートを抽出する理由 API 手動で行う代わりに？
手動ルートは ワークシートを移動またはコピー Excelタブを右クリックし、「移動またはコピー」を選択し、「コピーを作成」にチェックを入れ、新しいファイルとして保存します。これをシートごと、ワークブックごと、レポートサイクルごとに繰り返します。 API このループは、分割ごとに1つの決定論的なリクエストに置き換えられます。これは、ワークブックがスケジュール通りに届き、分割されたデータが他のシステムに供給される場合に最適です。出力は標準のままです。 オフィス営業中 XML ワークブック ExcelLibreOfficeとGoogleスプレッドシートがすべて開きます。