getAssetsByName

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

語法

授權的使用者型別

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
注意

僅傳回使用者有讀取存取權的資產。

參數

輸入(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 符合篩選條件的資產陣列。

範例

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

請求

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

本頁內容