Object Storage Service (OSS) に保存されている Word、PowerPoint、Excel、PDF などのドキュメントを、画像、テキストファイル、または PDF ファイルに変換するドキュメント変換タスクを作成します。
操作説明
-
この操作を使用する前に、Intelligent Media Management (IMM) の課金方法と料金を必ずご確認ください。
重要 非同期タスクの実行時間は保証されません。 -
サポートされている入力ファイル形式:
ワープロドキュメント (Word):doc、docx、wps、wpss、docm、dotm、dot、および dotx。
プレゼンテーションドキュメント (PowerPoint):pptx、ppt、pot、potx、pps、ppsx、dps、dpt、pptm、potm、ppsm、および dpss。
表計算ドキュメント (Excel):xls、xlt、et、ett、xlsx、xltx、csv、xlsb、xlsm、xltm、および ets。
PDF ドキュメント:pdf。
-
サポートされている出力ファイル形式:
画像:png および jpg。
テキスト:txt。
PDF:pdf。
-
単一ファイルの最大サイズは 200 MB です。この制限は変更できません。
-
ファイルが大きい場合や内容が複雑な場合、変換がタイムアウトすることがあります。
-
単一ユーザーの 1 秒あたりのリクエスト数は 50 に制限されています。
-
タスク情報は、タスク開始後 7 日間のみ保存されます。この期間を過ぎると、情報を取得できなくなります。次のいずれかの方法で、タスク情報を速やかに取得できます:
返された
TaskIdを使用して GetTask または ListTasks 操作を呼び出し、タスク情報を表示できます。IMM と同じリージョンで Message Service (MNS) をアクティブ化し、サブスクリプションを構成することで、タスク情報の通知を速やかに受信できます。非同期通知メッセージのフォーマットの詳細については、「非同期通知メッセージのフォーマット」をご参照ください。MNS の software development kit (SDK) の詳細については、「メッセージの受信と削除」をご参照ください。
IMM と同じリージョンで RocketMQ をアクティブ化し、RocketMQ 4.0 インスタンス、Topic、およびグループを作成することで、タスク情報の通知を速やかに受信できます。非同期通知メッセージのフォーマットの詳細については、「非同期通知メッセージのフォーマット」をご参照ください。RocketMQ の使用方法の詳細については、「HTTP 用 SDK を使用した通常メッセージの送受信」をご参照ください。
IMM と同じリージョンで EventBridge をアクティブ化して接続することで、タスク情報の通知を速やかに受信できます。詳細については、「Intelligent Media Management IMM イベント」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
imm:CreateOfficeConversionTask |
create |
*Project
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ProjectName |
string |
必須 |
プロジェクト名。プロジェクト名の取得方法の詳細については、「プロジェクトの作成」をご参照ください。 |
test-project |
| SourceURI |
string |
任意 |
ソースデータのストレージの場所。 OSS の場所は oss://${Bucket}/${Object} の形式である必要があります。`${Bucket}` は現在のプロジェクトと同じリージョンにある OSS バケットの名前です。`${Object}` は、ファイル名拡張子を含むファイルの完全なパスです。 |
oss://test-bucket/test-object |
| Sources |
array<object> |
任意 |
入力画像のリスト。画像はリスト内の URI の順序で変換されます。(このパラメーターはまだ公開されていません。使用しないでください。) |
oss://imm-test/test.pptx |
|
object |
任意 |
入力画像に関する情報。 |
||
| URI |
string |
任意 |
ソース画像の OSS の場所。 OSS の場所は oss://${Bucket}/${Object} の形式である必要があります。${Bucket} は現在のプロジェクトと同じリージョンにある OSS バケットの名前です。${Object} は、ファイル名拡張子を含むファイルの完全なパスです。 サポートされている画像形式:jpg、jp2、png、tiff、webp、bmp、および svg。 |
oss://examplebucket/sampleobject.jpg |
| Rotate |
integer |
任意 |
画像の回転角度。有効値:
|
90 |
| TargetURI |
string |
任意 |
変換されたドキュメントの出力先のテンプレート。 アドレスは 説明
このパラメーターまたは `TargetURIPrefix` のいずれかを指定します。 |
oss://examplebucket/outputDocument.pdf |
| TargetURIPrefix |
string |
任意 |
ドキュメント変換後の出力ファイルのストレージの場所のプレフィックス。 プレフィックスは 説明
このパラメーターまたは `TargetURI` のいずれかを指定します。 |
oss://examplebucket/outputprefix/ |
| SourceType |
string |
任意 |
ソースデータの拡張子タイプ。デフォルトでは、ソースデータのタイプは OSS オブジェクトの拡張子によって決定されます。OSS オブジェクトに拡張子がない場合は、このパラメーターを設定できます。有効値:
|
doc |
| TargetType |
string |
必須 |
出力ファイルのタイプ。有効値:
|
png |
| UserData |
string |
任意 |
カスタム情報。この情報は非同期通知メッセージで返され、通知とご利用のサービスを関連付けるのに役立ちます。値の長さは最大 2,048 バイトです。 |
{ "id": "test-id", "name": "test-name" } |
| Tags |
object |
任意 |
カスタムタグ。値は辞書です。タグを使用してタスクを検索できます。 |
{ "key": "value" } |
| StartPage |
integer |
任意 |
ドキュメント変換の開始ページ。デフォルト値は 1 です。 説明
|
1 |
| EndPage |
integer |
任意 |
ドキュメント変換の終了ページ。デフォルト値は -1 で、開始ページから最終ページまですべてのページが変換されることを示します。 説明
|
-1 |
| Password |
string |
任意 |
ドキュメントを開くためのパスワード。パスワードで保護されたドキュメントを変換する場合に、このパラメーターを設定します。 |
123456 |
| ScalePercentage |
integer |
任意 |
ドキュメントの拡大縮小率。有効値:20~199。デフォルト値は 100 で、ドキュメントが拡大縮小されないことを示します。 説明
100 未満の値はドキュメントが縮小されることを示し、100 を超える値はドキュメントが拡大されることを示します。 |
100 |
| Quality |
integer |
任意 |
変換されたファイルの品質。有効値:0~100。値 0 は最低品質と最高パフォーマンスを示します。値 100 は最高品質と最低パフォーマンスを示します。デフォルトでは、システムはドキュメントの内容に基づいて適切な値を設定し、品質とパフォーマンスのバランスを取ります。 |
60 |
| Pages |
string |
任意 |
変換するページ番号。このパラメーターは `StartPage` および `EndPage` パラメーターよりも優先度が高くなります。フォーマットは次のとおりです:
|
1,2-4,7 |
| MaxSheetRow |
integer |
任意 |
表計算ドキュメントを画像に変換する際に変換する最大行数。デフォルトでは、すべての行が変換されます。 説明
このパラメーターは、LongPicture を |
10 |
| MaxSheetColumn |
integer |
任意 |
表計算ドキュメントを画像に変換する際に変換する最大列数。デフォルトでは、すべての列が変換されます。 説明
このパラメーターは、LongPicture を |
10 |
| SheetCount |
integer |
任意 |
表計算ドキュメントで画像に変換するワークシートの数。デフォルトでは、すべてのワークシートが変換されます。 |
1 |
| SheetIndex |
integer |
任意 |
表計算ドキュメントで画像に変換するワークシートの番号。有効値:1 から最後のワークシートの番号まで。デフォルト値は 1 です。 |
1 |
| FitToWidth |
boolean |
任意 |
表計算ドキュメントを画像または PDF ファイルに変換する際に、すべての列を 1 つの画像または PDF ページにレンダリングするかどうかを指定します。有効値:
|
false |
| FitToHeight |
boolean |
任意 |
表計算ドキュメントを画像または PDF ファイルに変換する際に、すべての行を 1 つの画像または PDF ページにレンダリングするかどうかを指定します。有効値:
|
false |
| FirstPage |
boolean |
任意 |
表計算ドキュメントを画像に変換する際に、変換結果の最初の画像のみを返すかどうかを指定します。画像内の行数と列数は、自動分割の結果です。有効値:
説明
このパラメーターは、LongPicture パラメーターを |
false |
| PaperSize |
string |
任意 |
表計算ドキュメントを画像に変換する際の用紙サイズ。出力画像は印刷されたページに似ています。有効値:
説明
このパラメーターは、FitToHeight および FitToWidth パラメーターと組み合わせて使用する場合にのみ有効です。 |
A4 |
| PaperHorizontal |
boolean |
任意 |
表計算ドキュメントを画像に変換する際に、用紙を水平に配置するかどうかを指定します。出力画像は印刷されたページに似ています。有効値:
|
false |
| TrimPolicy | TrimPolicy |
任意 |
表計算ドキュメント変換のトリミングポリシー。たとえば、表計算ドキュメントに多くの空の行と列が含まれている場合、トリミングポリシーが指定されていないと大量の空白が生成される可能性があります。 |
|
| ShowComments |
boolean |
任意 |
ワープロドキュメントを画像に変換する際に、コメントを表示するかどうかを指定します。有効値:
|
false |
| LongPicture |
boolean |
任意 |
ドキュメントを画像に変換する際に、長い画像に変換するかどうかを指定します。有効値:
説明
最大 20 ページを長い画像に結合できます。ページ数がこの制限を超えると、変換タスクが失敗する可能性があります。 |
false |
| ImageDPI |
integer |
任意 |
出力画像の DPI。有効値:96~600。デフォルト値は 96 です。 |
96 |
| LongText |
boolean |
任意 |
ドキュメントをテキストに変換する際に、長いテキストファイルに変換するかどうかを指定します。有効値:
|
false |
| HoldLineFeed |
boolean |
任意 |
ドキュメントをテキストに変換する際に、ドキュメント内の改行を保持するかどうかを指定します。有効値:
|
false |
| CredentialConfig | CredentialConfig |
任意 |
特別な要件がない場合は、このパラメーターを空のままにしてください。 チェーン権限付与の構成。このパラメーターは必須ではありません。詳細については、「チェーン権限付与を使用して他のエンティティのリソースにアクセスする」をご参照ください。 |
|
| Notification | Notification |
任意 |
メッセージ通知の構成。詳細については、Notification をクリックしてください。非同期通知メッセージのフォーマットの詳細については、「非同期通知メッセージのフォーマット」をご参照ください。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
非同期タスクの応答。 |
||
| RequestId |
string |
リクエスト ID。 |
FF3B7D81-66AE-47E0-BF69-157DCF18***** |
| TaskId |
string |
タスク ID。 |
formatconvert-00bec802-073a-4b61-ba3b-39bc2fdd***** |
| EventId |
string |
イベント ID。 |
2C2-1I0EG57VR37J4rQ8oKG6C9***** |
例
成功レスポンス
JSONJSON
{
"RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF18*****",
"TaskId": "formatconvert-00bec802-073a-4b61-ba3b-39bc2fdd*****",
"EventId": "2C2-1I0EG57VR37J4rQ8oKG6C9*****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。