Intelligent Media Management:GenerateWebofficeToken

• この操作を使用する前に、Intelligent Media Management の課金について理解してください。詳細については、料金を参照してください。

• OSS ファイルに対してクロスボーダーアクセスを行わないでください。たとえば、ファイルがシンガポールリージョンのバケットに保存されている場合、中国本土からプレビュー、読み取り、またはダウンロードリクエストを開始しないでください。このようなシナリオでは、クロスボーダーネットワーク環境によりネットワークリンクの品質が大幅に影響を受け、アクセスレイテンシの増加、プレビューの失敗、ダウンロードの中断、または不安定な接続が発生する可能性があります。ネットワークの安定性とアクセスエクスペリエンスは保証できません。クロスボーダーアクセスによる不確実性を回避するために、アクセスポイントとバケットが同じリージョンにあることを確認してください。

• アクセス認証情報は 30 分で期限切れになり、リフレッシュ認証情報は 1 日で期限切れになります。

• 返される有効期限は協定世界時 (UTC) であり、UTC+8 より 8 時間遅れています。

• サポートされる入力ファイルのフォーマット:

  • Word ドキュメント: doc、docx、txt、dot、wps、wpt、dotx、docm、dotm、rtf。

  • プレゼンテーションドキュメント (PPT): ppt、pptx、pptm、ppsx、ppsm、pps、potx、potm、dpt、dps。

  • Excel ドキュメント: et、xls、xlt、xlsx、xlsm、xltx、xltm、csv。

  • PDF ドキュメント: pdf。

• サポートされるファイルサイズの最大値は 200 MB です。

• サポートされるドキュメントの最大ページ数は 5,000 です。

• 2023 年 12 月 1 日より前に作成されたプロジェクトでは、ドキュメントのオープン回数に基づいて課金されます。現在は、API 呼び出し回数に基づいて課金されます。新しい課金モードに切り替えるには、新しいプロジェクトを作成してください。各 API 呼び出しは 1 人のユーザーのみが使用できます。呼び出しが再利用された場合、最後のユーザーのみがドキュメントに正常にアクセスでき、他のユーザーのアクセス権限は取り消されます。

• Intelligent Media Management と同じリージョンでメッセージサービス (MNS) を有効化し、MNS トピックとキューを作成してサブスクリプションを構成します。NotifyTopicName パラメーターを使用して MNS トピック名を渡すことで、ファイル保存に関するメッセージ通知を受信できます。MNS SDK の詳細については、メッセージの受信と削除を参照してください。 ファイル保存メッセージ通知の Message フィールドの JSON フォーマットの例については、WebOffice メッセージ通知フォーマットを参照してください。

典型的なシナリオの例

以下の例では、パラメーター構造に基づいていくつかの典型的なシナリオを説明します:

読み取り専用ファイルのプレビュー (PDF ファイルのプレビューに必須)

ドキュメントプレビューモード。ドキュメントはプレビューのみ可能で、編集はできません:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.pdf",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

大文字のファイル名拡張子を持つファイルのプレビュー

大文字のファイル名拡張子を持つファイルをプレビューするには、Filename パラメーターに小文字の拡張子を設定します:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.DOCX",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

ドキュメントの最初の 5 ページのみをプレビュー

ドキュメントは合計 10 ページあります。最初の 5 ページのみが表示されます:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

ドキュメントプレビューにパスワードを設定

ドキュメントプレビューにパスワードを設定するか、パスワードで保護されたソースファイルをパスワードなしで直接開きます:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Password" : "123456",
    "Permission" : "{'Readonly':'true'}"
}

ドキュメントプレビューにウォーターマークを追加

ドキュメントをプレビューするときにウォーターマークを追加します:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Watermark" : "{'Type':'1','Value':'Watermark value','Font':'bold 20px Serif'}",
    "Permission" : "{'Readonly':'true'}"
}

ドキュメントプレビュー中にツールバーを非表示

ドキュメントをプレビューするときにツールバーを非表示にします:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Hidecmb" : "true",
    "Permission" : "{'Readonly':'true'}"
}

履歴バージョンの表示、コピー、印刷、PDF へのエクスポートの権限を持つドキュメントのオンライン編集

履歴バージョンの表示、コピー、印刷、PDF へのエクスポートの権限を持つドキュメントをオンラインで編集します:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Permission" : "{'Readonly':'false','History':'true','Copy':'true','Print':'true','Export':'true'}"
}
```.

一般的なエラー。

ProjectName で指定されたプロジェクトが見つかりません。IMM コンソールに移動し、そのリージョンにプロジェクトが存在するかどうかを確認してください。

{
    "Code": "ResourceNotFound",
    "Message": "The specified resource acs:imm::xxx:project/xxx is not found"
}
```.

User パラメーターは必須です。このパラメーターが指定されているかどうかを確認してください。

{ "Code": "InvalidArgument.User", "Message": "The parameter User is required but not provided" }

User パラメーターが無効です。パラメーター値が有効な JSON フォーマットかどうかを確認してください。

{ "Code": "InvalidJSON parsing error, User", "Message": "Specified parameter JSON parsing error, User is not valid." }

Permission パラメーターが無効です。パラメーター値が有効な JSON フォーマットかどうかを確認してください。

{ "Code": "InvalidJSON parsing error, Permission", "Message": "Specified parameter JSON parsing error, Permission is not valid." }

Watermark パラメーターが無効です。パラメーター値が有効な JSON フォーマットかどうかを確認してください。

{ "Code": "InvalidJSON parsing error, Watermark", "Message": "Specified parameter JSON parsing error, Watermark is not valid." }

PreviewPages パラメーターのフォーマットが無効です。PreviewPages パラメーターの値を確認してください。

{ "Code": "InvalidPreviewPages", "Message": "Specified parameter PreviewPages is not valid." }

SourceURI で指定された OSS ファイルが存在しません。バケットにファイルが存在するかどうかを確認してください。

{ "Code": "ResourceNotFound", "Message": "The specified resource oss://xx is not found" }