getFolders getfolders

フォルダーパスから始まるすべてのフォルダーとサブフォルダーを返します。 getFolders 応答は、最大 100,000 個のフォルダーを返します。

フォルダーの目的 section-66e344d5333f42f1b060a0cba25935c3

フォルダーを使用して、サブフォルダーとアセットを整理できます。 すべてのフォルダーとアセット名は一意である必要があります。 同じ名前を共有するフォルダーやアセットは、異なるフォルダー階層にある場合でも名前空間の競合を引き起こします。
構文

認証済みユーザータイプ section-0dc7e17cb60f4cf7bcdb76648e5d2f8e

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalUser
  • ImagePortalContrib
  • ImagePortalContribUser
NOTE
ユーザーがフォルダーのデータを返すには、そのフォルダーへの読み取りアクセス権が必要です。

パラメーター section-0c1976503eaa418a9226b51667901176

入力 (getFoldersParam)

名前
種類
必須
説明
companyHandle
xsd:string
はい
会社への取り扱い。
accessUserHandle
xsd:string
いいえ
管理者が特定のユーザーを装うために使用します。
accessGroupHandle
xsd:string
いいえ
特定のグループでフィルターします。
folderPath
xsd:string
いいえ
フォルダとすべてのサブフォルダをリーフレベルで取得するルートフォルダ。 除外された場合は、会社のルートが使用されます。
assetTypeArray
types:StringArray
いいえ
指定されたアセットタイプのみを含むフォルダーを返します。
responseFieldArray
types:StringArray
いいえ
応答に含めるフィールドのリストが含まれます。
excludeFieldArray
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