Word文書からメタデータを抽出する - 文書分析 API
PDF4me Wordからメタデータを抽出する 詳細な文書分析機能により、Word文書から包括的なメタデータとプロパティを抽出できます。 API このサービスは、Word ファイルを処理し、組み込みのドキュメント プロパティ、カスタム プロパティ、ドキュメント統計、作成者情報、作成日、および改訂履歴を取得します。 API Word文書コンテンツは以下を通じて受信されます REST API 通話を利用して Base64 安全な送信のためのエンコード機能。文化固有のフォーマットとローカライズに対応しているため、文書管理、コンプライアンス追跡、コンテンツ分析、および企業文書ワークフローに最適です。
認証 API リクエスト
アクセスするには PDF4me REST APIすべてのリクエストには適切な認証情報を含める必要があります。認証により安全な通信が保証され、あなたが正規のユーザーであることが検証されます。 REST API。
主な機能
- 包括的なメタデータ抽出組み込みおよびカスタムのドキュメントプロパティをすべて取得します。
- 文書統計リアルタイムのページ数、単語数、文字数、段落数を取得します。
- 著者情報著者、管理者、会社、連絡先情報を抽出します。
- 日付/時刻プロパティ作成、変更、印刷のタイムスタンプを取得します。
- カスタムプロパティ: 自動プレフィックス付きで全てのカスタムドキュメントプロパティにアクセス
- 文化支援: 指定されたロケールに従って日付と時刻をフォーマットします
- 読み取り専用操作: 元の文書を変更せずにメタデータを抽出する
- 構造化出力: 整理されたメタデータを返す JSON 処理しやすい形式
REST API 終点
の PDF4me REST API 標準を使用する HTTP リソースとやり取りするためのメソッド。すべてのメタデータ抽出操作は、単一のエンドポイントを介して実行されます。
- 方法: POST
- 終点:
office/ApiV2Word/ExtractMetadata
REST API パラメータ
Wordからメタデータを抽出するためのパラメータの完全なリスト REST APIパラメータは、理解と実装を容易にするためにカテゴリ別に整理されています。
重要: アスタリスク (*) が付いているパラメータは必須であり、提供する必要があります。 API 正しく機能するため。
| パラメータ | 必須 | その機能 | 例 |
|---|---|---|---|
| document | Required | Source file. `Name` must end in `.docx` or `.doc`. | { "Name": "document.docx" } |
| document.Name | Required | File name including its extension. Type: string. | { "Name": "document.docx" } |
| 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. | |
| cultureName | Optional | Culture used to format the dates, e.g. `en-US` or `de-DE`. Type: string. | en-US |
出力
の PDF4me Wordからメタデータを抽出する REST API 処理モードに基づいて異なる応答を返します。 API メタデータをとして返します JSON 物体バイナリデータとしてではなく。
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
同期処理(デフォルト)
の API リクエストを処理し、以下を返します。
ステータスコード: 200 OK
コンテンツタイプ: application/json
応答本文:
{
"document": null,
"fileName": null,
"success": true,
"errorMessage": null,
"metadata": {
"Author": "John Doe",
"Title": "Project Proposal",
"Subject": "Q1 2024 Planning",
"Keywords": "planning, budget, strategy",
"Comments": "Draft version for review",
"Category": "Business",
"Company": "Acme Corporation",
"Manager": "Jane Smith",
"Created": "1/15/2024 10:30:00 AM",
"LastModified": "1/20/2024 2:45:00 PM",
"LastPrinted": "1/18/2024 9:15:00 AM",
"RevisionNumber": 3,
"TotalEditingTime": 120,
"Pages": 8,
"Words": 2150,
"Characters": 12800,
"Paragraphs": 45,
"Custom_Department": "Marketing",
"Custom_ProjectCode": "PRJ-2024-001",
"Custom_Confidential": "Internal"
}
}
回答欄:
- 書類 (Base64 メタデータ抽出には使用されません。null の場合があります。
- ファイル名 (文字列またはnull):メタデータ抽出には使用されません。nullの場合があります。
- 成功 (ブール値):リクエストが成功したかどうかを示します。
- エラーメッセージ (文字列またはnull):成功がfalseの場合のエラーの詳細
- メタデータ (オブジェクト):すべてのドキュメントプロパティを含む包括的なメタデータ辞書
使用方法:
- 抽出する
metadataからのフィールド JSON 応答 - 必要に応じて個々の物件にアクセス
- メタデータは、文書の分類、コンプライアンスの追跡、または分析に使用されます。
例(JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const author = data.metadata.Author;
const pageCount = data.metadata.Pages;
// Access any metadata property
非同期処理
非同期動作 (202 Accepted ポーリングによる)は、リクエストボディパラメータではなく、サーバー構成によって制御されます。有効にすると、 API ポーリングで202ステータスを返す場合があります URL で Location ヘッダー。 URL と GET 200件のリクエストを受け取るまで OK 同じ応答形状(以下を含む) metadata、 success、 errorMessage)
エラー応答
の API 標準を返します HTTP エラーコードとエラー詳細:
- 無効なリクエストパラメータ
- 必須項目が欠落しています(
書類と名前、ドキュメントコンテンツ) - 無効 Base64 エンコーディング
ドキュメントコンテンツ - 無効または破損したWord文書
- 無効または欠落 API 鍵
- API キーが正しくありません Base64 エンコードされた Authorization ヘッダー
- ない
認証: 基本ヘッダー
- サーバー側処理エラー
- ワード文書の処理エラー
- メタデータ抽出失敗
エラー応答フォーマット:
{
"error": "Error message describing what went wrong"
}
回答形式の詳細
重要: の API 常に返される JSON メタデータオブジェクト付き。
応答構造:
{
"document": "Base64 or null",
"fileName": "string or null",
"success": true,
"errorMessage": "string or null",
"metadata": {
// Built-in properties
"Author": "string",
"Title": "string",
"Subject": "string",
"Keywords": "string",
"Comments": "string",
"Category": "string",
"Company": "string",
"Manager": "string",
"Created": "string (formatted date/time)",
"LastModified": "string (formatted date/time)",
"LastPrinted": "string (formatted date/time)",
"RevisionNumber": "integer",
"TotalEditingTime": "integer (minutes)",
// Document statistics
"Pages": "integer",
"Words": "integer",
"Characters": "integer",
"Paragraphs": "integer",
// Custom properties (prefixed with Custom_)
"Custom_PropertyName": "value"
}
}
コンテンツタイプヘッダー:
- 成功:
application/json - メタデータは構造化された形式で返されます JSON 物体
メタデータへのアクセス:
JavaScript/Node.js:
const metadata = response.metadata;
console.log(`Author: ${metadata.Author}`);
console.log(`Pages: ${metadata.Pages}`);
console.log(`Words: ${metadata.Words}`);
Python:
metadata = response['metadata']
print(f"Author: {metadata['Author']}")
print(f"Pages: {metadata['Pages']}")
print(f"Words: {metadata['Words']}")
C#:
var metadata = response.Metadata;
Console.WriteLine($"Author: {metadata["Author"]}");
Console.WriteLine($"Pages: {metadata["Pages"]}");
Console.WriteLine($"Words: {metadata["Words"]}");
メタデータプロパティ
組み込みドキュメントプロパティ
| 物件名 | タイプ | 説明 | 例 |
|---|---|---|---|
| 著者 | String | 文書作成者名 | "John Doe" |
| タイトル | String | 文書タイトル | "Project Proposal" |
| 主題 | String | 文書の主題 | "Q1 2024 Planning" |
| キーワード | String | 文書キーワード(カンマ区切り) | "planning, budget, strategy" |
| コメント | String | 文書コメント | "Draft version for review" |
| カテゴリ | String | 文書カテゴリ | "Business" |
| 会社 | String | 会社名 | "Acme Corporation" |
| マネージャー | String | マネージャー名 | "Jane Smith" |
| 作成済み | String | 文書作成日時(書式設定済み) | "1/15/2024 10:30:00 AM" |
| 最終更新日 | String | 最終保存日時(フォーマット済み) | "1/20/2024 2:45:00 PM" |
| 最終印刷日 | String | 最終印刷日時(書式設定済み) | "1/18/2024 9:15:00 AM" |
| 改訂番号 | Integer | 文書改訂番号 | 3 |
| 総編集時間 | Integer | 編集にかかった合計時間(分) | 120 |
文書統計
| 物件名 | タイプ | 説明 | 例 |
|---|---|---|---|
| ページ | Integer | 総ページ数 | 8 |
| 言葉 | Integer | 総単語数 | 2150 |
| キャラクター | Integer | 合計文字数 | 12800 |
| 段落 | Integer | 段落の総数 | 45 |
カスタムプロパティ
カスタムプロパティには、 Custom_ 回答の中で:
Custom_Department- 税関部門の所有物Custom_ProjectCode- カスタムプロジェクトコードプロパティCustom_Confidential- 顧客の機密レベル- Word文書で定義されているその他のカスタムプロパティ
サポートされている文化の例
| カルチャーコード | 説明 | 日付形式の例 |
|---|---|---|
en-US | 英語(アメリカ合衆国) | 「2024年1月15日 午前10時30分」 |
en-GB | 英語(イギリス) | 「2024/01/15 10:30:00」 |
de-DE | ドイツ語(ドイツ) | 「2024年1月15日 10:30:00」 |
fr-FR | フランス語(フランス) | 「2024/01/15 10:30:00」 |
es-ES | スペイン語(スペイン) | 「2024/01/15 10:30:00」 |
ja-JP | 日本語(日本) | 「2024/01/15 10:30:00」 |
リクエスト例
ヘッダ
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": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC..."
}
高度な例(オプションフィールド付き):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"cultureName": "en-US"
}
コードサンプル
の PDF4me Wordからメタデータを抽出する REST API 複数のプログラミング言語のコードサンプルを提供します。開発環境に最適な言語を選択してください。
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
業界におけるユースケースとアプリケーション
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
法律・専門サービスにおけるユースケース
- 文書分類訴訟の種類、依頼者、または専門分野別に法的文書を分類する
- コンプライアンス追跡: 規制遵守のため、文書の作成日と改訂履歴を監視する。
- クライアント文書管理: クライアントファイルの整理のためにドキュメントのプロパティを追跡します
- 監査証跡の保守: 法的監査要件のためのログ文書メタデータ
ビジネスおよび企業向けユースケース
- 提案管理: 顧客追跡および分析のために提案書からメタデータを抽出する
- マーケティング資料の構成キャンペーンと対象顧客別にマーケティング資料を分類する
- コンテンツパフォーマンス分析: コンテンツ最適化のために文書統計を分析する
- クライアントへの成果物追跡: クライアントプロジェクト管理のためのドキュメントプロパティの監視
教育・研究における活用事例
- 医療文書分類患者、処置、または診療科別に医療文書を分類する
- 研究資料研究追跡のために研究文書からメタデータを抽出する
- 学術記録および患者記録メタデータプロパティに基づいて学術文書と患者文書を整理する
- コンプライアンスと倫理医療および研究規制遵守に関する文書メタデータの監視
金融・銀行業務におけるユースケース
- 財務報告分析: コンプライアンス追跡のために財務報告書からメタデータを抽出する
- 予算文書管理予算関連書類を部門別および会計年度別に分類する
- 監査文書: 監査証跡の維持のために文書のプロパティを追跡する
- 規制当局への届出: 規制当局への提出要件に関する文書メタデータを監視する