DocumentaçãoAPI do sistema de produção de imagens Dynamic Media

getAssetsByName getassetsbyname

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor
  • Administrador

Retorna ativos com base em uma matriz de nomes de ativos.

Sintaxe

Tipos de usuário autorizados section-754790841ea242d5ae8bedd587d7730e

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
NOTE
Retorna somente ativos aos quais o usuário tem acesso de leitura.

Parâmetros section-f64e93c127b84a29aa3bf2fdd916cca9

Entrada (getAssetsByNameParam)

Nome
Tipo
Obrigatório
Descrição
companyHandle
xsd:string
Sim
O identificador 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.
strictSubTypeCheck
xsd:booleano
Não

Se true e assetSubTypeArray não estiver vazio, somente os ativos cujos subtipos estão em assetSubTypeArray serão retornados.

Se false, os ativos sem subtipo definido serã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 do filtro.

Exemplos section-3b7447398e574c88aeaf8ca159cc78dd

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