getAssetsByName

자산 이름의 배열을 기반으로 자산을 반환합니다.

구문

인증된 사용자 유형

IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser

노트

사용자가 읽기 권한을 가진 자산만 반환합니다.

매개 변수

입력(getAssetsByNameParam)

이름	유형	필수	설명
companyHandle	xsd:문자열	예	회사의 손잡이입니다.
accessUserHandle	xsd:문자열	아니요	다른 사용자로 액세스를 제공합니다. 관리자만 사용할 수 있습니다.
accessGroupHandle	xsd:문자열	아니요	특정 그룹으로 필터링하는 데 사용됩니다.
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	아니요	응답에서 제외된 필드 및 하위 필드 목록을 포함합니다.

출력(getAssetsByNameReturn)

이름	유형	필수	설명
``assetArray``	`types:AssetArray`	아니요	필터 기준과 일치하는 자산의 배열입니다.

예제

이 코드 샘플은 2개의 이미지 유형 에셋을 반환합니다.

요청

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