getAssetsByName getassetsbyname

Devuelve recursos en función de una matriz de nombres de recursos.

Sintaxis

Tipos de usuarios autorizados section-754790841ea242d5ae8bedd587d7730e

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
NOTE
Solo devuelve los recursos a los que el usuario tiene acceso de lectura.

Parámetros section-f64e93c127b84a29aa3bf2fdd916cca9

Entrada (getAssetsByNameParam)

Nombre
Tipo
Obligatorio
Descripción
companyHandle
xsd:string
El identificador de la compañía.
accessUserHandle
xsd:string
No
Proporciona acceso como otro usuario. Disponible solo para administradores.
accessGroupHandle
xsd:string
No
Se utiliza para filtrar por un grupo específico.
nameArray
tipos:StringArray
Matriz de nombres de recursos que se van a recuperar.
assetTypeArray
tipos:StringArray
No
Matriz de tipos de recursos permitidos para los recursos recuperados.
excludeAssetTypeArray
tipos:StringArray
No
Matriz de tipos de recursos excluidos para los recursos recuperados.
assetSubTypeArray
tipos:StringArray
No
Matriz de subtipos de recursos permitidos para los recursos recuperados.
strictSubTypeCheck
xsd:boolean
No

If true y assetSubTypeArray no está vacío, solo recursos cuyos subtipos están en assetSubTypeArray se devuelven.

If falseA continuación, se incluyen los recursos sin subtipo definido.

El valor predeterminado es false.

responseFieldArray
tipos:StringArray
No
Contiene una lista de campos y subcampos incluidos en la respuesta.
excludeFieldArray
tipos:StringArray
No
Contiene una lista de campos y subcampos excluidos de la respuesta.

Salida (getAssetsByNameReturn)

Nombre
Tipo
Obligatorio
Descripción
assetArray
types:AssetArray
No
Matriz de recursos que coinciden con los criterios de filtro.

Ejemplos section-3b7447398e574c88aeaf8ca159cc78dd

Este ejemplo de código devuelve dos recursos de tipo de imagen.

Solicitar

<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>

Respuesta

<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>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681