getFolders getfolders

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

개발자
관리자

폴더 경로에서 시작하여 모든 폴더 및 하위 폴더를 반환합니다. getFolders 응답은 최대 100,000개의 폴더를 반환합니다.

폴더 용도 section-66e344d5333f42f1b060a0cba25935c3

폴더를 사용하면 하위 폴더와 에셋을 구성할 수 있습니다. 모든 폴더 및 자산 이름은 고유해야 합니다. 동일한 이름을 공유하는 폴더 및 자산은 서로 다른 폴더 계층 구조에 있더라도 네임스페이스 충돌을 일으킵니다.
구문

승인된 사용자 유형 section-0dc7e17cb60f4cf7bcdb76648e5d2f8e

IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalUser
ImagePortalContrib
ImagePortalContribUser

NOTE

사용자는 폴더에 대한 데이터를 반환하려면 폴더에 대한 읽기 액세스 권한이 있어야 합니다.

매개 변수 section-0c1976503eaa418a9226b51667901176

입력(getFoldersParam)

이름

유형

필수

설명

company핸들

xsd:string

예

회사 손잡이.

accessUser핸들

xsd:string

아니요

관리자가 특정 사용자를 가장하는 데 사용됩니다.

액세스 그룹 핸들

xsd:string

아니요

특정 그룹으로 필터링합니다.

folderPath

xsd:string

아니요

폴더 및 모든 하위 폴더를 리프 수준으로 검색할 루트 폴더입니다. 제외되는 경우 회사 루트가 사용됩니다.

assetTypeArray

types:StringArray

아니요

지정된 자산 유형만 포함하는 폴더를 반환합니다.

responseFieldArray

types:StringArray

아니요

응답에 포함할 필드 목록을 포함합니다.

exclude필드 배열

types:StringArray

아니요

응답에서 제외할 필드 목록을 포함합니다.

출력(getFoldersReturn)

이름

유형

필수

설명

folderArray

types:FolderArray

아니요

필터 조건과 일치하는 폴더의 배열입니다. 응답은 최대 100,000개의 폴더로 제한됩니다.

permissionsSetArray

types:PermissionSetArray

예제 section-b5cb06e9fb9945ad898dbdc3692b754e

이 코드 샘플은 각 폴더에 대한 특정 정보와 함께 회사의 모든 폴더가 포함된 배열을 반환합니다.

요청

<ns1:getFoldersParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
</ns1:getFoldersParam>

응답

<getFoldersReturn xmlns="http://www.scene7.com/IpsApi/xsd">
   <folderArray>
      <items>
         <folderHandle>MyCompany/</folderHandle>
         <path>MyCompany/</path>
         <hasSubfolders>false</hasSubfolders>
      </items>
      <items>
         <folderHandle>MyCompany/eCatalogs/</folderHandle>
         <path>MyCompany/eCatalogs/</path>
         <hasSubfolders>false</hasSubfolders>
      </items>
      <items>
         <folderHandle>MyCompany/PDF/</folderHandle>
         <path>MyCompany/PDF/</path>
         <hasSubfolders>false</hasSubfolders>
      </items>
   </folderArray>
</getFoldersReturn>

recommendation-more-help

4e9b9d8c-5839-4215-aa35-01b652869681