DocumentaciónAPI del sistema de producción de imágenes Dynamic Media

getAssetsByName getassetsbyname

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

Creado para:

  • Desarrollador
  • Administrador

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

Si true y assetSubTypeArray no están vacíos, solo se devuelven los recursos cuyos subtipos están en assetSubTypeArray.

Si es false, se incluyen los recursos sin un 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.

Solicitud

<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