すべてのプロダクト
Search
ドキュメントセンター

:CreateOfficeConversionTask

最終更新日:Jan 27, 2026

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 イベント」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

imm:CreateOfficeConversionTask

create

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

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

任意

画像の回転角度。有効値:

  • 0 (デフォルト)

  • 90

  • 180

  • 270

90

TargetURI

string

任意

変換されたドキュメントの出力先のテンプレート。

アドレスは oss://{bucket}/{tags.custom}/{dirname}/{barename}.{autoext} の形式である必要があります。詳細については、「TargetURI テンプレート」をご参照ください。

説明

このパラメーターまたは `TargetURIPrefix` のいずれかを指定します。

oss://examplebucket/outputDocument.pdf

TargetURIPrefix

string

任意

ドキュメント変換後の出力ファイルのストレージの場所のプレフィックス。

プレフィックスは oss://${Bucket}/${Prefix}/ の形式である必要があります。`${Bucket}` は現在のプロジェクトと同じリージョンにある OSS バケットの名前です。`${Prefix}` は出力ファイルのストレージの場所のプレフィックスです。

説明

このパラメーターまたは `TargetURI` のいずれかを指定します。

oss://examplebucket/outputprefix/

SourceType

string

任意

ソースデータの拡張子タイプ。デフォルトでは、ソースデータのタイプは OSS オブジェクトの拡張子によって決定されます。OSS オブジェクトに拡張子がない場合は、このパラメーターを設定できます。有効値:

  • ワープロドキュメント (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

doc

TargetType

string

必須

出力ファイルのタイプ。有効値:

  • png:ドキュメントを PNG 画像に変換します。

  • jpg:ドキュメントを JPG 画像に変換します。

  • pdf:ドキュメントを PDF ファイルに変換します。

  • txt:ドキュメントをテキストのみのファイルに変換します。これは主に、ファイルからテキストコンテンツを抽出するために使用されます。このオプションは、プレゼンテーションドキュメント、ワープロドキュメント、および表計算ドキュメントでのみサポートされています。表計算ドキュメントを変換する場合、単一の txt ファイルが生成され、シート関連の変数の設定は有効になりません。

png

UserData

string

任意

カスタム情報。この情報は非同期通知メッセージで返され、通知とご利用のサービスを関連付けるのに役立ちます。値の長さは最大 2,048 バイトです。

{ "id": "test-id", "name": "test-name" }

Tags

object

任意

カスタムタグ。値は辞書です。タグを使用してタスクを検索できます。

{ "key": "value" }

StartPage

integer

任意

ドキュメント変換の開始ページ。デフォルト値は 1 です。

説明
  • ソースファイルが表計算ドキュメントの場合は、ワークシート番号を指定する必要があります。

  • このパラメーターは、ドキュメントを画像に変換する場合にのみ有効です。ドキュメントを PDF ファイルまたはテキストファイルに変換する場合には有効になりません。

1

EndPage

integer

任意

ドキュメント変換の終了ページ。デフォルト値は -1 で、開始ページから最終ページまですべてのページが変換されることを示します。

説明
  • ソースファイルが表計算ドキュメントの場合は、ワークシート番号 (`SheetIndex`) を指定する必要があります。

  • ドキュメントのページ数が多い場合は、バッチで変換することを推奨します。そうしないと、変換がタイムアウトする可能性があります。

  • このパラメーターは、ドキュメントを画像に変換する場合にのみ有効です。ドキュメントを PDF ファイルまたはテキストファイルに変換する場合には有効になりません。

-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)。

  • 連続するページの範囲をハイフン (-) で指定します (例:1,2-4,7)。

1,2-4,7

MaxSheetRow

integer

任意

表計算ドキュメントを画像に変換する際に変換する最大行数。デフォルトでは、すべての行が変換されます。

説明

このパラメーターは、LongPicturetrue に設定した場合にのみ有効です。

10

MaxSheetColumn

integer

任意

表計算ドキュメントを画像に変換する際に変換する最大列数。デフォルトでは、すべての列が変換されます。

説明

このパラメーターは、LongPicturetrue に設定した場合にのみ有効です。

10

SheetCount

integer

任意

表計算ドキュメントで画像に変換するワークシートの数。デフォルトでは、すべてのワークシートが変換されます。

1

SheetIndex

integer

任意

表計算ドキュメントで画像に変換するワークシートの番号。有効値:1 から最後のワークシートの番号まで。デフォルト値は 1 です。

1

FitToWidth

boolean

任意

表計算ドキュメントを画像または PDF ファイルに変換する際に、すべての列を 1 つの画像または PDF ページにレンダリングするかどうかを指定します。有効値:

  • false (デフォルト):いいえ。コンテンツは複数の画像または PDF ページにレンダリングされます。

  • true:はい。コンテンツは 1 つの画像または PDF ページにレンダリングされます。

false

FitToHeight

boolean

任意

表計算ドキュメントを画像または PDF ファイルに変換する際に、すべての行を 1 つの画像または PDF ページにレンダリングするかどうかを指定します。有効値:

  • false (デフォルト):いいえ。コンテンツは複数の画像または PDF ページにレンダリングされます。

  • true:はい。コンテンツは 1 つの画像または PDF ページにレンダリングされます。

false

FirstPage

boolean

任意

表計算ドキュメントを画像に変換する際に、変換結果の最初の画像のみを返すかどうかを指定します。画像内の行数と列数は、自動分割の結果です。有効値:

  • false (デフォルト):いいえ。すべての画像が返されます。

  • true:はい。最初の画像のみが返されます。これはサムネイルを抽出するために使用されます。

説明

このパラメーターは、LongPicture パラメーターを true に設定した場合にのみ有効です。

false

PaperSize

string

任意

表計算ドキュメントを画像に変換する際の用紙サイズ。出力画像は印刷されたページに似ています。有効値:

  • A0

  • A2

  • A4 (デフォルト)

説明

このパラメーターは、FitToHeight および FitToWidth パラメーターと組み合わせて使用する場合にのみ有効です。

A4

PaperHorizontal

boolean

任意

表計算ドキュメントを画像に変換する際に、用紙を水平に配置するかどうかを指定します。出力画像は印刷されたページに似ています。有効値:

  • false (デフォルト):いいえ。用紙は垂直に配置されます。

  • true:はい。用紙は水平に配置されます。

false

TrimPolicy TrimPolicy

任意

表計算ドキュメント変換のトリミングポリシー。たとえば、表計算ドキュメントに多くの空の行と列が含まれている場合、トリミングポリシーが指定されていないと大量の空白が生成される可能性があります。

ShowComments

boolean

任意

ワープロドキュメントを画像に変換する際に、コメントを表示するかどうかを指定します。有効値:

  • false (デフォルト):いいえ。コメントは表示されません。

  • true:はい。コメントは表示されます。

false

LongPicture

boolean

任意

ドキュメントを画像に変換する際に、長い画像に変換するかどうかを指定します。有効値:

  • false (デフォルト):いいえ。ドキュメントは複数の画像に変換されます。

  • true:はい。ドキュメントは長い画像に変換されます。

説明

最大 20 ページを長い画像に結合できます。ページ数がこの制限を超えると、変換タスクが失敗する可能性があります。

false

ImageDPI

integer

任意

出力画像の DPI。有効値:96~600。デフォルト値は 96 です。

96

LongText

boolean

任意

ドキュメントをテキストに変換する際に、長いテキストファイルに変換するかどうかを指定します。有効値:

  • false (デフォルト):いいえ。ドキュメントの各ページは別々のテキストファイルに変換されます。

  • true:はい。すべてのコンテンツが 1 つのテキストファイルに配置されます。

false

HoldLineFeed

boolean

任意

ドキュメントをテキストに変換する際に、ドキュメント内の改行を保持するかどうかを指定します。有効値:

  • false (デフォルト):いいえ。改行は保持されません。

  • true:はい。改行は保持されます。

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*****"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。