文件Dynamic Media Image Production System API

搜尋資產 searchassets

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

建立對象：

  • 開發人員
  • 管理員

根據您指定的條件搜尋資產。

語法

searchAssets：關於 section-4ad74f12eb754768bf85bd235a7e25f0

searchAssets是擷取IPS資產的主要方法。 此方法可用於各種用途，例如瀏覽檔案夾階層或依名稱尋找特定資產。

回應大小

searchAssets在單一呼叫中最多可傳回1000個資產。 若要傳回每個呼叫最多10,000個資產，請將回應資料限製為totalRows、name、handle、type和subType欄位的子集。 若要傳回較大的集合，請使用resultPage引數設定分頁。

使用responseFieldArray或excludeFieldArray限制結果檔案大小

使用responseFieldArray或excludFieldArray引數限制資料集的大小。 這些引數有助於減少記憶體使用量和頻寬，並可改善伺服器回應時間。

授權的使用者型別 section-9c4bc41bb8b4493982197eb13c7cdc55

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalUser
  • ImagePortalContrib
  • ImagePortalContribUser
NOTE
使用者必須擁有讀取存取權才能傳回資產。

參數 section-49aabc0600764f55a8b7017d86ded44f

輸入(searchAssetsParam)

名稱
類型
必填？
說明
companyHandle
xsd：string
是
擁有您要搜尋之資產的公司的控制代碼。
accessUserHandle
xsd：string
否
可讓管理員以其他使用者的身分工作。
accessGroupHandle
xsd：string
否
可讓管理員加入不同的群組。
資料夾
xsd：string
否
用於搜尋資產的根路徑。 如果省略，則使用公司根資料夾。
includeSubfolders
xsd：布林值
否
設定為 true以搜尋子資料夾。
publishState
xsd：string
否
Publish州選擇。
trashState
xsd：string
否
垃圾桶狀態選擇。 預設值為 NotInTrash。
conditionMatchMode
xsd：string
否

選擇用於組合 keywordArray結果的搜尋比對模式

conditionMatchMode

systemFieldConditionArray和 metadataConditionArray。 預設為 MatchAll。

keywordArray
型別：StringArray
否

注意：已棄用的引數。 建議您不要使用它。

要比對的關鍵字字字串陣列。

systemFieldMatchMode
xsd：string
否

選擇搜尋比對模式以合併個systemFieldCondition符合專案。 預設為 MatchAll

.

systemFieldConditionArray
型別：SystemFieldConditionArray
否
系統欄位條件的陣列。
tagMatchMode
xsd：string
否
搜尋比對模式字串常數。 預設值為 MatchAll。
tagConditionArray
型別：TagConditionArray
否

標籤欄位搜尋述詞的陣列。

述詞是根據 tagMatchMode設定進行組合，然後根據 conditionMatchMode設定與 keywordArray、 systemFieldConditionArray和 metadataConditionArray中的任何字詞進行組合。

metadataMatchMode
xsd：string
否
搜尋符合模式以合併 metadataCondition個符合專案。 預設為 MatchAll。
metadataConditionArray
型別：MetadataConditionArray
否
中繼資料欄位搜尋條件的陣列。
assetTypeArray
型別：StringArray
否
要包含在搜尋中的資產型別陣列。
excludeAssetTypeArray
型別：StringArray
否
要從搜尋排除的資產型別陣列。
assetSubTypeArray
型別：StringArray
否
要篩選的子型別名稱清單。
strictSubTypeCheck
xsd：布林值
否
如果 true和 assetSubTypeArray不是空的，則只會傳回子型別位於 assetSubTypeArray中的資產。 如果 false （預設），則會傳回未定義子型別的資產。
excludeByproducts
xsd：布林值
否
如果為True，則擷取主要資產期間產生的副產品資產(例如擷取的PDF頁面影像)會從搜尋結果中排除。 預設為 false。
excludByproductArray
型別：ExcludeByproductArray
否
要從搜尋結果排除的副產品資產產生條件陣列。 如果存在，此引數會覆寫excludeByproducts設定。
專案控制代碼
xsd：sting
否
包含要搜尋之資產的專案控制代碼。
recordsPerPage
xsd：int
否
要傳回的結果數上限。
個結果頁面
xsd：int
否
根據 recordsPerPage頁面大小，指定要傳回的結果頁面。
sortBy
xsd：string
否
選擇資產排序欄位。
sortDirection
xsd：string
否
選擇排序方向。
responseFieldArray
型別：StringArray
否
包含要包含在回應中的欄位和子欄位清單。
excludeFieldArray
型別：StringArray
否
包含從回應中排除的欄位和子欄位清單。

輸出(searchAssetsReturn)

名稱
類型
必要
說明
totalRows
xsd:int
否
每頁的記錄數不受限制時，搜尋傳回的列數。
assetArray
types:AssetArray
否
搜尋傳回的Assets。

範例 section-725484cc09b54772a838ad2cc930b94b

此程式碼範例會搜尋屬於特定公司的影像資產。 為簡短起見，回應會遭截斷。

要求

<ns1:searchAssetsParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:includeSubfolders>true</ns1:includeSubfolders>
   <ns1:assetTypeArray>
      <ns1:items>Image</ns1:items>
   </ns1:assetTypeArray>
</ns1:searchAssetsParam>

回應

<searchAssetsReturn xmlns="http://www.scene7.com/IpsApi/xsd">
   <totalRows>210</totalRows>
   <assetArray>
      <items>
         <assetHandle>24265|1|17061</assetHandle>
         <type>Image</type>
         <name>Autumn Leaves</name>
         ...
      </items>
    </assetArray>
</searchAssetsReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681