renameAsset

上次更新: 2023-05-26
  • 建立對象:
  • Developer
    Admin

重新命名資產。

注意

renameFiles 舊版已棄用引數,並已從以下版本中移除: renameAsset. 虛擬檔案路徑會變更為符合新的資產名稱(保留副檔名),而實體檔案路徑則不受影響。 API使用者端在更新至新API版本時需要移除此引數的參考。

授權的使用者型別

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImpagePortalContribUser
注意

使用者必須擁有資產的讀取和寫入存取權。

參數

輸入(renameAssetParam)

名稱 類型 必要 說明
companyHandle xsd:string 資產所屬公司的控制代碼。
assetHandle xsd:string 您要重新命名的資產的控制代碼。
newName xsd:string 資產的新名稱。
validateName xsd:boolean 如果 validateNametrue 且資產型別需要唯一的IPS ID,則會檢查新名稱是否有全域唯一性,以及 renameAsset 如果錯誤不是唯一的,則會擲回錯誤。

輸出(renameAssetReturn)

IPS API未傳回此作業的回應。 請參閱「 」的說明 <ns1:validateName> 元素,以取得關於此元素的警告。

範例

此程式碼範例會重新命名資產

請求

<ns1:renameAssetParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:assetHandle>24265|1|17061</ns1:assetHandle>
   <ns1:newName>My Newly Renamed Image</ns1:newName>
   <ns1:validateName>true</ns1:validateName>
   <ns1:renameFiles>true</ns1:renameFiles>
</ns1:renameAssetParam>

回答

無。

本頁內容