getAssetsByName getassetsbyname

Returns assets based on an array of asset names.

Syntax

Authorized User Types section-754790841ea242d5ae8bedd587d7730e

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
NOTE
Only returns assets to which the user has read access.

Parameters section-f64e93c127b84a29aa3bf2fdd916cca9

Input (getAssetsByNameParam)

Name
Type
Required
Description
companyHandle
xsd:string
Yes
The handle to the company.
accessUserHandle
xsd:string
No
Provides access as another user. Available to administrators only.
accessGroupHandle
xsd:string
No
Used to filter by a specific group.
nameArray
types:StringArray
Yes
Array of asset names to retrieve.
assetTypeArray
types:StringArray
No
Array of asset types allowed for retrieved assets.
excludeAssetTypeArray
types:StringArray
No
Array of Asset Types excluded for retrieved assets.
assetSubTypeArray
types:StringArray
No
Array of asset subtypes allowed for retrieved assets.
strictSubTypeCheck
xsd:boolean
No

If true and assetSubTypeArray is not empty, only assets whose subtypes are in assetSubTypeArray are returned.

If false, then assets with no defined subtype are included.

The default value is false.

responseFieldArray
types:StringArray
No
Contains a list of fields and subfields included in the response.
excludeFieldArray
types:StringArray
No
Contains a list of fields and subfields excluded from the response.

Output (getAssetsByNameReturn)

Name
Type
Required
Description
assetArray
types:AssetArray
No
Array of assets that match the filter criteria.

Examples section-3b7447398e574c88aeaf8ca159cc78dd

This code sample returns two image type assets.

Request

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

Response

<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