renameAsset renameasset

重新命名資產。

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

授權的使用者型別 section-cc27ad713c6d498b8f056850b20976f4

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImpagePortalContribUser
NOTE
使用者必須擁有資產的讀寫存取權。

參數 section-ef95a994106841e0ab346dd4cf672258

輸入(renameAssetParam)

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

輸出(renameAssetReturn)

IPS API未傳回此作業的回應。 請參閱<ns1:validateName>專案的說明,瞭解此專案的注意事項。

範例 section-a0ddffd62bec42e09069f22ceb486f8a

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

要求

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

回應

無。

recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681