[AEM Assets]{class="badge positive" title="Aplicável ao AEM Assets)."}

Perguntas frequentes sobre o Dynamic Media com recursos OpenAPI new-dynaminc-media-apis-frequently-asked-questions

O Dynamic Media com os recursos da OpenAPI (Interface de Programação de Aplicativo Aberta) fornece, transforma e gerencia ativos de mídia avançada (imagens, vídeo e outros conteúdos visuais) por meio de pontos de extremidade de API padronizados e amigáveis para desenvolvedores. Este guia de perguntas frequentes responde às perguntas mais comuns sobre como esses recursos funcionam, o que eles permitem e como adotá-los.

O que é o Dynamic Media com recursos OpenAPI? what-are-dynamic-media-openapi-capabilities

O Dynamic Media é um conjunto de serviços de entrega e transformação de mídia que otimizam, redimensionam e renderizam automaticamente ativos para qualquer dispositivo, canal ou tela. Os recursos de OpenAPI expõem esses serviços por meio de especificações de API abertas e bem documentadas, permitindo que os desenvolvedores integrem a entrega de mídia diretamente em seus próprios aplicativos, vitrines e experiências de conteúdo.

Como as interfaces seguem o padrão OpenAPI, elas são autodescritivas e previsíveis. Como resultado, as equipes de integração podem descobrir endpoints disponíveis, entender formatos de solicitação e resposta e gerar código de cliente mais rapidamente do que com interfaces proprietárias não documentadas.

Principais benefícios key-benefits

As principais vantagens do Dynamic Media com recursos OpenAPI incluem:

O que posso fazer com os recursos OpenAPI do Dynamic Media? what-can-i-do

Você pode solicitar ativos de mídia sob demanda, aplicar transformações em tempo real, como recorte, redimensionamento e conversão de formatos, e fornecer conteúdo otimizado para experiências da Web, móveis e conectadas, tudo isso por meio de chamadas de API padronizadas.

Como os recursos da OpenAPI diferem da entrega tradicional do Dynamic Media? openapi-vs-traditional

A entrega tradicional depende de padrões e modelos de URL predefinidos. Os recursos da OpenAPI adicionam uma interface padronizada e programática que facilita a implementação de arquiteturas de automação, integração personalizada e headless (front-end dissociado).

Esses recursos são adequados para arquiteturas headless e combináveis? headless-composable

Sim. Como a mídia é recuperada e transformada por meio de APIs em vez de modelos de página fixos, os recursos da OpenAPI do Dynamic Media se encaixam naturalmente nas configurações de gerenciamento de conteúdo headless e comércio combinável, onde a camada de apresentação é separada do conteúdo e dos serviços.

Preciso de recursos do desenvolvedor para usar esses recursos? developer-resources

A integração baseada em API geralmente envolve desenvolvedores para conectar endpoints a um aplicativo. No entanto, a especificação OpenAPI reduz esse esforço, fornecendo definições consistentes e legíveis por máquina que oferecem suporte à geração e ao teste automatizados de clientes.

Todos os ativos no repositório do Experience Manager Assets as a Cloud Service estão disponíveis para pesquisa e entrega usando o Dynamic Media com recursos OpenAPI? assets-available-for-search

Não. Somente a versão aprovada e a mais recente dos ativos estão disponíveis para pesquisa e entrega usando o Dynamic Media com recursos OpenAPI. Os Assets que não foram aprovados, ou que existem somente como revisões anteriores, são excluídos deste escopo de pesquisa e entrega.

Duas condições determinam se um ativo no repositório do Experience Manager Assets as a Cloud Service é revelado:

Esse escopo é intencional. Como somente os ativos atuais aprovados estão qualificados, a entrega está restrita ao conteúdo que passou na revisão de governança, o que garante a consistência da marca em todos os canais e aplicativos. Como resultado, as experiências de downstream que consomem ativos por meio do Dynamic Media com recursos OpenAPI fazem referência a conteúdo atualizado e verificado de maneira confiável, em vez de revisões não aprovadas ou desatualizadas.

Como os administradores podem marcar ativos novos e existentes adicionados a uma pasta como aprovados? add-assets-to-folder-as-approved

Os administradores marcam ativos novos e existentes em uma pasta como aprovado, configurando a pasta para aprovação em massa e reprocessando quaisquer ativos pré-existentes. No Adobe Experience Manager (AEM) Assets, o status de um ativo é regido pela propriedade jcr:content/metadata/dam:status. Essa propriedade controla se um ativo é tratado como utilizável, bloqueado ou com revisão pendente na biblioteca de ativos.

Os valores dessa propriedade são:

O AEM Assets distingue o status Aprovado usando um ícone aprovado disponível no cartão de ativos, conforme ilustrado nas imagens a seguir para as exibições de Administrador e Ativo:

Modo de exibição de administrador

exibição do Assets

Para aprovar todos os ativos em uma pasta, consulte as instruções em como aprovar ativos em massa em uma pasta. Há também um vídeo que mostra todo o processo.

Depois de configurar uma pasta para aprovação em massa, todos os novos ativos adicionados à pasta são aprovados automaticamente. Isso garante um status de aprovação consistente em toda a pasta, sem exigir a revisão manual de cada novo upload. Todos os ativos existentes são aprovados somente depois que são reprocessados, pois o reprocessamento reavalia a propriedade dam:status em relação à configuração de aprovação em massa da pasta. Consulte Reprocessando ativos digitais para obter instruções sobre como reprocessar ativos. Se os administradores copiarem ou moverem ativos não aprovados de qualquer outra pasta, eles deverão reprocessar os ativos para que os ativos movidos herdem o status de aprovado.

O AEM Assets marca o ativo como Rejected sempre que o administrador especifica os valores Rejected ou Changes requested, pois ambos os valores representam um estado não aprovado. O AEM Assets distingue o status Rejeitado usando disponível no cartão de ativos na exibição de Administrador.

Da mesma forma, o AEM Assets distingue o status Rejeitado na exibição do Assets usando o seguinte status Rejeitado no cartão de ativos:

Como você pode fazer com que a ID de usuário ou de grupo do Adobe IMS (Adobe Identity Management Services) seja usada para definir as funções em ativos na exibição de administrador do Experience Manager, para proteger a experiência de entrega e pesquisa? set-roles-secure-delivery-search

As IDs de usuário e de grupo do Adobe IMS (Adobe Identity Management Services) são recuperadas da Admin Console da Adobe e aplicadas em Experience Manager Assets Admin view para definir funções que garantam experiências de entrega e pesquisa. A atribuição de funções com base nessas IDs de usuário ou grupo IMS garante que somente as identidades autorizadas possam acessar, entregar ou pesquisar ativos específicos. Como o acesso no nível do ativo é regido por essas identidades, o uso da ID do IMS correta é a etapa fundamental para a segurança com base em funções no Experience Manager.

Os usuários que precisam de acesso ao ambiente Experience Manager Author são gerenciados como usuários do Adobe IMS no Admin Console da Adobe. Para obter informações sobre o que são os usuários do Adobe IMS e como eles são acessados e gerenciados no Admin Console, consulte Usuários do Adobe IMS.

Como as identidades IMS são mapeadas para funções de ativos:

Como as experiências de entrega e pesquisa são regidas pelas funções definidas nos ativos, recuperar a ID precisa de usuário ou grupo do Adobe IMS na Admin Console é essencial. Essa abordagem centraliza o gerenciamento de identidades, reduz o risco de acesso não autorizado aos ativos e mantém as permissões alinhadas com a forma como as identidades já são administradas no ambiente do Adobe.

É possível aprovar vários ativos simultaneamente em uma pasta? approve-multiple-assets-in-folder

Sim. O Adobe Experience Manager (AEM) Assets permite que os usuários aprovem vários ativos simultaneamente em uma pasta, eliminando a necessidade de aprovar cada arquivo individualmente. A aprovação em massa simplifica os fluxos de trabalho de revisão e economiza um tempo considerável ao gerenciar bibliotecas de ativos grandes, pois o status de revisão Aprovado é aplicado a cada ativo selecionado em uma única ação.

Há dois métodos com suporte, dependendo da interface usada: o modo de exibição de Administração do Assets ou o modo de exibição do Assets.

Aprovar vários ativos na exibição de administrador do Assets

Execute as seguintes etapas para aprovar vários ativos simultaneamente no Experience Manager Assets Admin view:

Isso aplica o status de revisão Aprovado a cada ativo selecionado de uma só vez, confirmando e fechando as alterações em uma única etapa.

Aprovar vários ativos na exibição do Assets

Da mesma forma, para aprovar vários ativos simultaneamente em uma pasta na exibição do Assets:

Clicar em Salvar confirmará o status Aprovado para todos os ativos selecionados simultaneamente, garantindo estados de revisão consistentes em toda a pasta.

Como posso proteger a entrega de ativos e pesquisar o Dynamic Media com OpenAPIs? secure-asset-delivery

A governança de ativos centrais na Adobe Experience Manager oferece aos Administradores de Gerenciamento de Ativos Digitais (DAM) e aos Gerentes de Marca controle direto sobre quem pode acessar ativos entregues por meio das OpenAPIs (Interfaces de Programação de Aplicativos Abertos). Esse modelo de governança protege a pesquisa de ativos e a entrega de ativos, aplicando regras de acesso na origem para que somente os usuários autorizados recuperem o conteúdo protegido.

Esses administradores restringem o acesso no lado da criação — especificamente na instância do autor do AEM as a Cloud Service — usando dois controles primários:

Como esses controles são aplicados no nível de criação, eles controlam cada solicitação downstream. Os usuários finais que pesquisam ativos ou usam URLs de entrega só recebem ativos restritos depois de passarem com êxito pelo processo de autorização. As solicitações com falha de autorização são bloqueadas, o que impede a recuperação não autorizada mesmo quando um URL de entrega é conhecido. Isso garante que as decisões de governança tomadas pelos administradores do DAM e gerentes de marca sejam aplicadas de forma consistente nos resultados da pesquisa e nos links de entrega direta.

Para obter mais informações, consulte Restringir o acesso aos ativos no Experience Manager.

Como você pode obter permissões para editar o status de aprovação de um ativo? permissions-edit-approval-status

Para obter permissões para editar o status de aprovação de um ativo, um administrador deve conceder acesso de edição ao campo Status da revisão dentro do esquema de metadados aplicado à pasta do ativo. Como usuário do Gerenciamento de ativos digitais (DAM), talvez você não tenha permissões para aprovar ativos por padrão, pois a aprovação e a edição do status da revisão são controladas no nível do esquema de metadados, não pelo acesso geral às pastas.

Os administradores podem habilitar esse acesso seguindo estas etapas:

Conceder permissões de edição ao campo Status da revisão garante que os usuários designados do DAM possam alterar diretamente o status de aprovação de um ativo, simplificando o fluxo de trabalho de revisão. Para obter mais informações, consulte como desabilitar a edição para o campo Status de Revisão.

Qual é o tamanho de arquivo suportado para vídeos? supported-file-formats-videos

O Dynamic Media com recursos OpenAPI oferece suporte a vídeos de formulário longos com tamanho máximo de arquivo de 50 GB e duração máxima de 2 horas por vídeo. Esses limites definem os limites superiores para um único upload de vídeo, permitindo que conteúdo de longa duração, como webinários gravados, sessões de treinamento, demonstrações de produtos e apresentações estendidas, seja entregue sem dividir a sequência em segmentos mais curtos.

Como o Dynamic Media acomoda arquivos com até 50 GB, é possível fazer upload e transmitir sequências de alta resolução e alta taxa de bits, preservando a qualidade. O limite de duração de 2 horas garante que os ativos de forma longa se encaixem em um único arquivo contínuo, o que simplifica o gerenciamento de conteúdo e a reprodução para visualizadores.

Como o Dynamic Media com recursos OpenAPI é diferente da solução Dynamic Media? dynamic-media-and-dynamic-media-with-openapi-differences

O Dynamic Media com recursos OpenAPI e Dynamic Media são soluções distintas, cada uma oferecendo seus próprios recursos de delivery especializados. Analise minuciosamente seus requisitos específicos para determinar a solução que melhor se alinha às suas necessidades.

A orientação geral da Adobe é aproveitar a pilha Dynamic Media com OpenAPI (Interface de Programação de Aplicativos Abertos) para quaisquer casos de uso de integração, independentemente de envolverem aplicativos próprios ou de terceiros. Como as duas pilhas usam estruturas de URL diferentes, use as seguintes regras de decisão para escolher a abordagem correta:

Concluindo, o Dynamic Media e o Dynamic Media com pilha de OpenAPI podem coexistir, dependendo da natureza do caso de uso.

Estas são algumas das principais diferenças entre o Dynamic Media com recursos OpenAPI e o Dynamic Media:

Como o Dynamic Media com recursos OpenAPI aborda as limitações do recurso Connected Assets? dynamic-media-openapi-addresses-connected-assets-limitations

O Dynamic Media com recursos OpenAPI supera as principais limitações do recurso Connected Assets eliminando a cópia binária, oferecendo suporte a todos os tipos de formato AEM Assets (incluindo vídeos), removendo o limite de conexão de quatro instâncias, permitindo integrações personalizadas extensíveis e fornecendo atualizações de ativos quase em tempo real. A tabela abaixo descreve as principais diferenças entre as duas soluções:

Alguns modificadores são marcados como Disponibilidade Limitada. Como posso começar a usá-los? use-limited-availability-modifiers

Modificadores de disponibilidade limitada exigem ativação explícita em sua conta antes que possam ser usados na produção. A Adobe não ativa esses modificadores por padrão, portanto, você deve solicitar acesso por meio do Suporte da Adobe. O processo consiste em duas etapas: abrir um caso de suporte e fornecer os detalhes de identificação de que a Adobe precisa para provisionar os recursos solicitados.

Para habilitar o uso de produção de modificadores em Disponibilidade Limitada na sua conta:

Como testar modificadores experimentais? modifiers-not-generally-available

As APIs experimentais permitem testar qualquer modificador que ainda não está disponível no geral. As APIs experimentais (ou beta) fornecem aos desenvolvedores acesso antecipado a funcionalidades que ainda estão sob avaliação, para que você possa validar novos modificadores antes que eles sejam promovidos para o conjunto estável e geralmente disponível. Isso permite que você experimente recursos futuros, confirme se eles se comportam conforme esperado em seus fluxos de trabalho e forneça feedback antes de uma versão geral.

Para testar um modificador que geralmente não está disponível, chame-o por meio do caminho da API experimental. Por exemplo:

</adobe/experimental/advancemodifiers-expires-YYYYMMDD/assets>

O segmento expires-YYYYMMDD indica que o modificador experimental está vinculado ao tempo, sinalizando a data até a qual a versão experimental deve mudar ou expirar — um lembrete para migrar para o equivalente geralmente disponível depois de lançado.

Para obter detalhes sobre como chamar esses endpoints, consulte as orientações sobre como usar as APIs experimentais. Para identificar quais modificadores estão disponíveis, consulte a lista completa de modificadores.

Consulte também