Intelligent Media Management：GenerateWebofficeToken

• 請確保在使用該介面前，已充分了解智慧媒體管理產品的收費方式和價格。

• 不建議對 OSS 檔案執行跨境存取操作。例如，檔案儲存在新加坡地域的 Bucket 中，卻從中國內地發起預覽、讀取或下載請求。在此類場景下，網路鏈路品質受跨境網路環境影響較大，可能出現存取延遲升高、預覽失敗、下載中斷或連線不穩定等情況，因此無法保證網路穩定性和存取體驗。建議盡量確保存取端與 Bucket 所在地域保持一致，避免跨境存取帶來的不確定性。

• 存取憑證過期時間為 30 分鐘，重新整理憑證過期時間為 1 天。

• 返回的過期時間為 UTC 時間，和北京時間有 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。

• 支援最大的檔案 200MB。

• 支援最大的文件頁數 5000 頁。

• 2023-12-01 之前建立的專案，按照文件開啟次數計費。目前按照 API 介面呼叫次數計費。如需切換成新的計費模式，建立新的專案即可，但需要注意，一次 API 呼叫只能給一個使用者使用，若重複使用，則只有最後一個使用者可以正常存取，其餘使用者的存取權限將被回收。

• 在與智慧媒體管理相同的地域下開通 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':'水印值','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 檔案不存在，請檢查 Bucket 下該檔案是否存在。

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