SearchAssets searchassets
Suche nach Assets basierend auf Ihren angegebenen Kriterien.
Syntax
searchAssets: Über section-4ad74f12eb754768bf85bd235a7e25f0
searchAssets
ist die primäre Methode zum Abrufen von IPS-Assets. Diese Methode wird für verschiedene Zwecke verwendet, z. B. zum Durchsuchen der Ordnerhierarchie oder zum Suchen eines bestimmten Assets anhand des Namens.
Antwortgröße
searchAssets
gibt in einem einzigen Aufruf bis zu 1.000 Assets zurück. Um bis zu 10.000 Assets pro Aufruf zurückzugeben, beschränken Sie die Antwortdaten auf eine Teilmenge der Felder totalRows
, name
, handle
, type
und subType
. Um größere Mengen zurückzugeben, richten Sie das Paging mit dem resultPage
Parameter ein.
Ergebnisdateigröße mit responseFieldArray oder excludeFieldArray begrenzen
Begrenzen Sie die Größe Ihres Datensatzes mit den responseFieldArray
- oder excludFieldArray
. Diese Parameter tragen dazu bei, die Speichernutzung und Bandbreite zu reduzieren und die Reaktionszeiten des Servers zu verbessern.
Autorisierte Benutzertypen section-9c4bc41bb8b4493982197eb13c7cdc55
IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalUser
ImagePortalContrib
ImagePortalContribUser
Parameter section-49aabc0600764f55a8b7017d86ded44f
Eingabe (searchAssetsParam)
Auswahl der Such-Match-Modi zum Kombinieren der Ergebnisse KeywordArray,
conditionMatchMode
systemFieldConditionArray und metadataConditionArray. Die Standardeinstellung ist MatchAll.
Hinweis: Veralteter Parameter. Es wird empfohlen, es nicht zu verwenden.
Ein Zeichenfolgen-Array von abzugleichenden Schlüsselwörtern.
Auswahl der Such-Übereinstimmungsmodi zum Kombinieren systemFieldCondition Übereinstimmungen. Die Standardeinstellung ist MatchAll
.
Ein Array von Tag-Feld-Sucheigenschaften.
Prädikate werden gemäß der Einstellung tagMatchMode kombiniert und dann mit beliebigen Begriffen in SchlüsselwortArray, systemFieldConditionArray und metadataConditionArray gemäß der Einstellung conditionMatchMode kombiniert.
Ausgabe (searchAssetsReturn)
xsd:int
types:AssetArray
Beispiele section-725484cc09b54772a838ad2cc930b94b
In diesem Code-Beispiel wird nach Bild-Assets gesucht, die zu einem bestimmten Unternehmen gehören. Die Antwort wird zur Vereinfachung gekürzt.
Anfrage
<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>
Antwort
<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>