Cargar un recurso de imagen de trama

Para poder cargar un recurso de imagen, primero debe solicitar una clave secreta compartida. Esta clave permite recuperar un distintivo de carga. A continuación, utilice el token de carga para cargar recursos de imagen de trama.

IMPORTANTE

La compatibilidad con los recursos vectoriales UGC nuevos o existentes en Adobe Dynamic Media Classic finalizó el 30 de septiembre de 2021.

Solicitar una clave secreta compartida

Solicite una clave secreta compartida utilizando el Admin Console para crear un caso de soporte. En su caso de asistencia, solicite una clave secreta compartida.

En el mensaje, proporcione el nombre de empresa que desee utilizar para cargar los recursos de imagen. Cuando reciba la clave de Adobe Dynamic Media Classic, guárdela localmente para usarlo más adelante.

Recuperar el token de carga

El distintivo de carga garantiza que nadie más use la misma clave secreta compartida para cargar recursos. Garantiza que la carga sea legítima y que proceda de una fuente de confianza.

El distintivo de carga es una cadena alfanumérica que solo se encuentra disponible durante un tiempo concreto. Utilice las siguientes direcciones URL, sustituyendo la clave secreta compartida, para poder recuperar el token de carga.

  • Imagen rasterizada
    https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602En este ejemplo, la clave secreta compartida es fece4b21-87ee-47fc-9b99-2e29b78b602

De manera predeterminada, el distintivo de carga caduca en 5 minutos (300 segundos) después de recuperarlo. Si desea solicitar más tiempo, incluya en la URL expires seguido de la cantidad de tiempo necesaria en segundos. Por ejemplo, esta URL de imagen de ejemplo recupera un distintivo de carga válido durante 1.800 segundos:

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

La respuesta correcta para las imágenes es similar a la siguiente:

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

Guarde el distintivo de carga en el equipo local para utilizarlo en las futuras solicitudes.

Se pueden usar los campos siguientes en la cadena de consulta URL para recuperar un distintivo de carga:

Parámetro de URL Obligatorio u opcional Valor
op Obligatorio get_uploadtoken
shared_secret Obligatorio Clave secreta compartida de la empresa que realiza la carga.
expires Opcional Número de segundos durante los que es válido el distintivo de carga. Si no se especifica, el valor predeterminado es 300 segundos.

URL de imagen de trama de ejemplo:

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

Métodos HTTP permitidos:
GET y POST

Ya puede cargar un recurso de imagen.

Consulte Cargar un recurso de imagen.

Cargar un recurso de imagen de trama

Después de recuperar un distintivo de carga válido durante un tiempo determinado, ya se puede cargar un recurso de imagen. El recurso se carga como una publicación de varias partes o formularios mientras que el resto de los valores se envía en forma de cadena de consulta URL, tal como se muestra en este ejemplo:

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

Los campos upload_token y company_name son obligatorios.

Consulte Recuperar el token de carga.

Consulte Recuperar una clave secreta compartida.

También se pueden enviar otros valores opcionales en forma de cadenas de consulta URL, como en este ejemplo:

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

El parámetro file_limit especifica el límite de tamaño de archivo en bytes. El parámetro file_exts especifica las extensiones de nombre de archivo permitidas en la carga. Ambos valores son opcionales.

En la aplicación se definen límites globales tanto para el límite de tamaño de los archivos como para las extensiones de nombre de archivo permitidas. Todo lo incluido en la solicitud se acepta si es un subconjunto de los límites globales. Éstos son los límites globales:

Límite global Valor
Tamaño de archivo para todos los clientes 20 MB
Formatos de archivo de imagen admitidos para la carga BMP, GIF, JPG, PNG y PSD, TIFF

El siguiente formulario HTML permite al usuario cargar un recurso. En el formulario se pide al usuario que introduzca la información siguiente:

  • Nombre de empresa.
  • Distintivo de carga.
  • Límite de tamaño de archivo.
  • Lista de extensiones de nombre de archivo.
  • Si se desea conservar el perfil de color y el nombre de archivo asociados al recurso.
  • Si se utiliza el fondo de Knockout. Si activa Fondo de Knockout, defina la Esquina, Tolerancia y Método de Relleno.
    Consulte Contexto de Knockout en Opciones de ajuste de imágenes en upload.
  • Nombre del archivo que se debe cargar.

Puede ver el código fuente HTML asociado con el formulario anterior seleccionando https://s7ugc1.scene7.com/ugc/upload.html

En Firefox, haga clic con el botón derecho en la ventana del explorador y, a continuación, seleccione Ver origen de página. El código muestra la cadena de consulta URL y el método POST oportunos que se ejecutan cuando el usuario hace clic en Enviar.

Para ver la respuesta XML en Internet Explorer, vaya a View > Source. Para ver la respuesta XML en Firefox, vaya a Tools > Browser Tools > Web Developer Tools. Se recomienda utilizar Firefox para ver las respuestas en XML.

A continuación se muestra una respuesta de carga correcta de ejemplo:

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

El recurso cargado (JPG, GIF, etc.) se convierte al formato PTIFF y la respuesta envía un vínculo directo a ese recurso PTIFF.

El recurso es igual que cualquier otro recurso de servicio de imágenes, es decir, se le pueden aplicar consultas de procesamiento. Por ejemplo, la URL siguiente solicita un recurso ajustado con la anchura y la altura especificadas.

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

Envíe el recurso para la carga como una publicación de varias partes o formularios y el resto de los valores en forma de cadena de consulta URL. Se pueden usar los campos siguientes en la cadena de consulta URL para cargar un recurso:

Parámetro de URL Obligatorio u opcional Valor
op Obligatorio cargar
upload_token Obligatorio Distintivo de carga para la clave secreta compartida asociada a la empresa.
company_name Obligatorio Nombre de la empresa que realiza la carga.
file_limit Opcional Límite de tamaño de archivo, en bytes, del recurso.
file_exts Opcional Lista de extensiones admitidas para el archivo de recurso de imagen.
preserve_colorprofile Opcional Conserva el perfil de color incrustado al convertir el archivo cargado a formato PTIFF. Los valores posibles son true y false. El valor predeterminado es false.
preserve_filename Opcional Conserva el nombre de archivo del recurso cargado. Los valores posibles son true y false. El valor predeterminado es false.
NOTA

Es obligatorio enviar el recurso que se desea cargar como el único campo en las solicitudes POST de varias partes.

URL de ejemplo:

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

Método HTTP permitido:

POST

Obtener metadatos de recursos para imágenes

Se puede usar image_info para recuperar los metadatos de cualquier recurso cargado, tal como se muestra en el siguiente ejemplo:

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

Un ejemplo de respuesta correcta es similar al siguiente:

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

Se pueden usar los campos siguientes en la cadena de consulta URL para solicitar información de un recurso:

Parámetro de URL Obligatorio u opcional Valor
op Obligatorio image_info
shared_secret Obligatorio Clave secreta compartida de la empresa.
image_name Obligatorio Nombre de la imagen.

URL de ejemplo:

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

En esta página