getAssetsByName

마지막 업데이트: 2024년 7월 22일

주제:

작성 대상:

개발자
관리자

에셋 이름의 배열을 기반으로 에셋을 반환합니다.

구문

승인된 사용자 유형

IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser

NOTE

사용자가 읽기 액세스 권한이 있는 자산만 반환합니다.

매개 변수

입력(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>

recommendation-more-help