Retorna ativos com base em uma matriz de nomes de ativos.
Sintaxe
IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser
Retorna somente ativos aos quais o usuário tem acesso de leitura.
Entrada (getAssetsByNameParam)
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
companyHandle | xsd:string | Sim | O nome da empresa. |
accessUserHandle | xsd:string | Não | Fornece acesso como outro usuário. Disponível somente para administradores do . |
accessGroupHandle | xsd:string | Não | Usado para filtrar por um grupo específico. |
nameArray | tipos:StringArray | Sim | Matriz de nomes de ativos a serem recuperados. |
assetTypeArray | tipos:StringArray | Não | Matriz de tipos de ativos permitidos para ativos recuperados. |
excludeAssetTypeArray | tipos:StringArray | Não | Matriz de tipos de ativos excluídos para ativos recuperados. |
assetSubTypeArray | tipos:StringArray | Não | Matriz de subtipos de ativos permitidos para ativos recuperados. |
hardSubTypeCheck | xsd:boolean | Não | If true e assetSubTypeArray não está vazio, somente ativos cujos subtipos estão em assetSubTypeArray são retornadas. If false, ativos sem subtipo definido são incluídos. O valor padrão é false. |
responseFieldArray | tipos:StringArray | Não | Contém uma lista de campos e subcampos incluídos na resposta. |
excludeFieldArray | tipos:StringArray | Não | Contém uma lista de campos e subcampos excluídos da resposta. |
Saída (getAssetsByNameReturn)
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
assetArray | types:AssetArray |
Não | Matriz de ativos que correspondem aos critérios de filtro. |
Essa amostra de código retorna dois ativos do tipo imagem.
Solicitação
<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>
Resposta
<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>