Fazer upload de um ativo de imagem rasterizada uploading-an-image-asset-or-a-vector-asset

Antes de carregar um ativo de imagem, primeiro solicite uma chave de segredo compartilhado. Você usa essa chave de segredo compartilhado para recuperar um token de upload. Em seguida, use o token de upload para fazer upload de ativos de imagem rasterizada.

IMPORTANT
A partir de 1 de maio de 2023, os ativos UGC no Dynamic Media estarão disponíveis para uso por até 60 dias a partir da data do upload. Após 60 dias, os ativos serão removidos.
NOTE
O suporte para ativos vetoriais UGC novos ou existentes no Adobe Dynamic Media Classic terminou em 30 de setembro de 2021.

Solicitar uma chave de segredo compartilhado requesting-a-shared-secret-key

Solicitar um chave de segredo compartilhado por usar o Admin Console para criar um caso de suporte. No caso de suporte, solicite uma chave de segredo compartilhado.

Na mensagem de email, forneça o nome da empresa que você deseja usar para fazer upload de ativos de imagem. Depois de receber a chave do Adobe Dynamic Media Classic, salve-a localmente para uso futuro.

Recuperar o token de upload retrieving-the-upload-token

A variável fazer upload do token A garante que ninguém possa usar a mesma chave de segredo compartilhado para carregar ativos. Ele garante que o upload seja legítimo e venha de uma fonte confiável.

O token de upload é uma sequência alfanumérica que está disponível somente por um período específico. Use os URLs a seguir, substituindo sua chave de segredo compartilhado, para que você possa recuperar o token de upload.

  • Imagem raster
    https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602Neste exemplo, a chave de segredo compartilhado é fece4b21-87ee-47fc-9b99-2e29b78b602

Por padrão, o token de upload expira cinco minutos (300 segundos) após a recuperação. Para solicitar mais tempo, inclua expires no URL e o tempo necessário em segundos. Por exemplo, o seguinte URL de imagem de amostra recupera um token de upload válido por 1800 segundos:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800

A resposta bem-sucedida para imagens é semelhante ao seguinte:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
        <serviceName>User Generated Content - Images</serviceName>
        <version>1.0.0</version>
        <operationName>get_uploadtoken</operationName>
        <serviceStatus>SUCCESS</serviceStatus>
        <title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title>
        <message>
            <uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken>
            <expiration_in_seconds>1800</expiration_in_seconds>
        </message>
        </response>
    </user_generated_content>
</scene7>

Salve o token de upload localmente para uso com solicitações futuras.

Você pode usar os seguintes campos na cadeia de caracteres do URL de consulta para recuperar um token de upload:

Parâmetro de URL
Obrigatório ou opcional
Valor
op
Obrigatório
get_uploadtoken
shared_secret
Obrigatório
A chave de segredo compartilhado para a empresa que está fazendo o upload.
expira em
Opcional
Número de segundos que o token de upload é válido. O padrão é 300 segundos, se não for especificado.

Amostra da URL da imagem rasterizada:

https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600

Métodos HTTP permitidos:
GET e POST

Agora você pode fazer upload de um ativo de imagem.

Consulte Fazer upload de um ativo de imagem.

Fazer upload de um ativo de imagem rasterizada uploading-an-image-asset

Depois de recuperar um token de upload válido por um período específico, você pode fazer upload de um ativo de imagem. Você faz upload do ativo como uma publicação multipart/form enquanto envia o restante dos valores como uma cadeia de caracteres de consulta de URL, conforme mostrado neste exemplo:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

A variável upload_token e company_name campos são obrigatórios.

Consulte Recuperar o token de upload.

Consulte Recuperar uma chave de segredo compartilhado.

Você também pode enviar outros valores opcionais como cadeias de caracteres de consulta de URL, como neste exemplo:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif

A variável file_limit O parâmetro especifica o limite do tamanho do arquivo em bytes. A variável file_exts parameter especifica as extensões de nome de arquivo permitidas para upload. Ambos os valores são opcionais.

Um limite global é definido no aplicativo para o limite de tamanho do arquivo e as extensões de nome do arquivo permitidas. Se o que você enviou na solicitação for um subconjunto dos limites globais, ele será atendido. Os limites globais são os seguintes:

Limite global
Valor
Tamanho do arquivo para todos os clientes
20 MB
Formatos de arquivo de imagem aceitos para upload
BMP, GIF, JPG, PNG, PSD, TIFF

O formulário HTML a seguir permite que um usuário carregue um ativo. O formulário solicita que o usuário insira as seguintes informações:

  • Um nome de empresa.
  • Um token de upload.
  • Um limite de tamanho de arquivo.
  • Uma lista de extensões de nome de arquivo.
  • Se o perfil de cores e o nome do arquivo associados ao ativo devem ser preservados.
  • Usar plano de fundo de separação. Se você ativar Plano de fundo de separação, defina o Canto, a Tolerância e o Método de preenchimento.
    Consulte Plano de fundo de separação em Opções de ajuste de imagem no upload.
  • O nome do arquivo a ser carregado.

Você pode exibir o código-fonte do HTML associado ao formulário acima selecionando https://s7ugc1.scene7.com/ugc/upload.html

No Firefox, clique com o botão direito do mouse na janela do navegador e selecione View Page Source. O código mostra a string de consulta de URL correspondente e o método POST executado quando o usuário seleciona Submit.

Para exibir a resposta XML no Internet Explorer, vá para View > Source. Para exibir a resposta XML no Firefox, acesse Tools > Browser Tools > Web Developer Tools. O Firefox é recomendado para exibir respostas XML.

Este é um exemplo de resposta de um upload bem-sucedido:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
            <serviceName>User Generated Content - Images</serviceName>
            <version>1.0.0</version>
            <operationName>upload</operationName>
            <serviceStatus>SUCCESS</serviceStatus>
            <title>Your file has been uploaded Successfully.</title>
            <message>
            <url>https://s7w2p1.scene7.com/is/image/ </url>
            <path>000Company/ugc/1442564.tif</path>
            <fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl>
            </message>
        </response>
    </user_generated_content>
</scene7>
NOTE
O ativo carregado (JPG, GIF e assim por diante) é convertido para o formato PTIFF e a resposta envia um link direto para esse ativo PTIFF.

O ativo é como qualquer outro recurso ImageServing; você pode aplicar consultas de processamento a ele. Por exemplo, o URL a seguir solicita um ativo que é ampliado até a largura e a altura especificadas.

https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch

Envie o ativo para fazer upload como uma publicação multipart/form enquanto envia o restante dos valores como uma cadeia de caracteres de consulta de URL. Você pode usar os seguintes campos na sequência de consulta do URL para fazer upload de um ativo:

Parâmetro de URL
Obrigatório ou Opcional
Valor
op
Obrigatório
upload
upload_token
Obrigatório
Token de upload para a chave de segredo compartilhado associada à empresa.
company_name
Obrigatório
Nome da empresa que está fazendo o upload.
file_limit
Opcional
Limite de tamanho do arquivo, em bytes, para o ativo.
file_exts
Opcional
Lista de extensões permitidas para o arquivo de ativo de imagem.
preserve_colorprofile
Opcional
Preserva qualquer perfil de cor incorporado ao converter o arquivo carregado para o formato PTIFF. Os valores possíveis são true ou false. O padrão é falso.
preserve_filename
Opcional
Preserva o nome de arquivo do ativo carregado. Os valores possíveis são true ou false. O padrão é falso.
NOTE
É necessário enviar o ativo para ser carregado como o único campo em uma solicitação POST de várias partes.

Amostra do URL:

https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

Método HTTP permitido:

POST

Obter metadados de ativos para imagens getting-asset-metadata-for-images

Você pode usar image_info para recuperar metadados de um ativo carregado, conforme mostrado no exemplo a seguir:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Um exemplo de resposta bem-sucedida é semelhante ao seguinte:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<scene7>
    <user_generated_content>
        <response>
            <serviceName>User Generated Content - Images</serviceName>
            <version>1.0.0</version>
            <operationName>image_info</operationName>
            <serviceStatus>SUCCESS</serviceStatus>
            <title>More information on 1442564.tif</title>
            <message>
            File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes
            <imageFormat>Tiff</imageFormat>
            <colorSpace>Rgb</colorSpace>
            <width>686</width>
            <height>457</height>
            </message>
        </response>
    </user_generated_content>
</scene7>

Você pode usar os seguintes campos na cadeia de caracteres de consulta do URL para solicitar informações de um ativo:

Parâmetro de URL
Obrigatório ou opcional
Valor
op
Obrigatório
image_info
shared_secret
Obrigatório
A chave que é um segredo compartilhado para a empresa.
image_name
Obrigatório
Nome da imagem.

Amostra do URL:

https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Método HTTP permitido:

GET e POST

recommendation-more-help
ba789e76-bace-4e0e-bd26-52691fb2cb26