getAssetsByName

根据资产名称数组返回资产。

语法

授权用户类型

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

仅返回用户具有读取权限的资产。

参数

输入(getAssetsByNameParam)

名称 类型 必需 说明
companyHandle xsd:string 公司的把手。
accessUserHandle xsd:string 以其他用户身份提供访问权限。 仅供管理员使用。
accessGroupHandle xsd:string 用于按特定组进行过滤。
nameArray types:StringArray 要检索的资产名称数组。
assetTypeArray types:StringArray 允许检索的资产使用的资产类型数组。
excludeAssetTypeArray types:StringArray 已检索资产中排除的资产类型数组。
assetSubTypeArray types:StringArray 已检索资产允许的资产子类型数组。
strictSubTypeCheck xsd:boolean

如果 true assetSubTypeArray不为空,则只返回子类型位于 assetSubTypeArray中的资产。

如果 false,则包含未定义子类型的资产。

默认值为 false

responseFieldArray types:StringArray 包含响应中包含的字段和子字段列表。
excludeFieldArray types:StringArray 包含从响应中排除的字段和子字段列表。

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

在此页面上