文件Dynamic Media Image Production System API

getAssetsByName getassetsbyname

Last update: Fri May 26 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer
  • Admin

根據資產名稱的陣列傳回資產。

語法

授權的使用者型別 section-754790841ea242d5ae8bedd587d7730e

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
NOTE
僅傳回使用者有讀取存取權的資產。

參數 section-f64e93c127b84a29aa3bf2fdd916cca9

輸入(getAssetsByNameParam)

名稱
類型
必要
說明
companyHandle
xsd:string
是
公司的控制代碼。
accessUserHandle
xsd:string
否
提供存取權給其他使用者。 僅供管理員使用。
accessGroupHandle
xsd:string
否
用於依特定群組篩選。
nameArray
型別：StringArray
是
要擷取的資產名稱陣列。
assetTypeArray
型別：StringArray
否
擷取資產允許的資產型別陣列。
excludeAssetTypeArray
型別：StringArray
否
為擷取的資產排除的資產型別陣列。
assetSubTypeArray
型別：StringArray
否
擷取資產允許的資產子型別陣列。
strictSubTypeCheck
xsd:boolean
否

若 true 和 assetSubTypeArray 不是空的，只有子型別位於以下位置的資產： assetSubTypeArray 會傳回。

若 false，則包含未定義子型別的資產。

預設值為 false.

responseFieldArray
型別：StringArray
否
包含回應中包含的欄位和子欄位清單。
excludeFieldArray
型別：StringArray
否
包含從回應中排除的欄位和子欄位清單。

輸出(getAssetsByNameReturn)

名稱
類型
必要
說明
assetArray
types:AssetArray
否
符合篩選條件的資產陣列。

範例 section-3b7447398e574c88aeaf8ca159cc78dd

此程式碼範例會傳回兩個影像型別資產。

請求

<getAssetsByNameParam xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <companyHandle>c|3</companyHandle>
   <nameArray>
      <items>B010</items>
      <items>IMG_0103</items>
   </nameArray>
   <assetTypeArray>
      <items>Image</items>
   </assetTypeArray>
</getAssetsByNameParam>

回答

<getAssetsByNameReturn xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <assetArray>
      <items>
         <assetHandle>a|210</assetHandle>
         <type>Image</type>
         <name>B010</name>
         ...</items>
      <items>
         <assetHandle>a|189</assetHandle>
         <type>Image</type>
         <name>IMG_0103</name>
         ...
      </items>
   </assetArray>
</getAssetsByNameReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681