：GenerateWebofficeToken - 擷取Weboffice憑證

• 請確保在使用該介面前，已充分瞭解Intelligent Media Management產品的收費方式和價格。

• 訪問憑證到期時間為 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 呼叫只能給一個使用者使用，若重複使用，則只有最後一個使用者可以正常訪問，其餘使用者的存取權限將被回收。

• 在與Intelligent Media Management相同的地區下開通 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"
}